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F88 Notebook Contents 



Chanteir 


Title 


1 


Dump Contents 


2 


Fault Vectoif 


3 


Crash Sequences 


4 


Stacks and Linkage Sections 


5 


Example PL/I Listing 


6 


analyzejmultics Example 


7 


analyze_jnultics Documentation 


8 


Data Formats 


9 


Signalling and Crawlouts 


10 


Machine Condition Examples 


11 


Interrupt Types 


12 
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CONTENTS OF DDMP 135 



BCE dump command: dump -run he pp moddir -elig he stk -inzr he pp 

Stored by copy_dump in segments: 

>dumps>010886 . 2303 . 0. 135 
>dumps>010886 . 2303 . 1 . 135 
>dumps>010886 . 2303 . 2 - 135 
>dumps>010886 . 2303 . 3 . 135 
>dumps>010886 . 2303 . 4 . 135 



Header 

Time, ERFNO, List of Segs 
Ovomp Machine Conditions 



Contents of Segments 



\ 



\ 
\ 

010886.2303.0.135 
/ 
/ 



\ 



\ 

\ 

010886.2303.1.135 
/ 

/ 



\ 



\ 

\ 

010886.2303.2.135 

/ 

/ 

J 
\ 



\ 

\ 

010886.2303.3.135 
/ 

/ 



\ 



\ 

\ 

010886.2303.4.135 
/ 

/ 
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Process 0, Initializer. SysDaemon.z, running (-inzr he pp) 



Seg# 


Len 


Name 


0 


3072 


dseff 


1 


1024 


bos toehold 


2 


4096 


conf ig deck 


3 


2048 


dn355 mailbox 


4 


1024 


fault vector 


5 


1024 


flagbox 


6 


9216 


name table 


7 


2048 


sit 


10 


2048 


toehold data 


11 


2048 


1 (Ytn Tna 1 1 bov 


12 


1024 


unpaged__page tables 


13 


2048 


toebol d 


14 


1024 


breakpoint_page 


15 


1024 


lot 


16 


17408 


as linkage 


17 


5120 


ws XinTcaiye 


20 


79872 


definitions 


22 


0 


abs segl 


25 


2048 


bound he data wired 


52 


50176 


core map 


54 


1024 


disk_post queue seg 


55 


29696 


disk seg 


56 


1024 


dn355 data 


60 


2048 


emergency shutdown 


62 


5120 


idle dsegs 


63 


5120 


idle_pdses 


64 


2048 


init_processor 


65 


8192 


inzr stkO 


66 


18432 


ioi abs seg 


67 


6144 


io_conf ig_data 


70 


11264 


ioi__data 


71 


3072 


iom data 


72 


8192 


kst seg 


73 


1024 


oe__data 


74 


2048 


pds 


75 


7168 


prds 


76 


3072 


pvt 


77 


0 


rdisk seg 


102 


27648 


seas 


104 


55296 


sst_names_ 


105 


256000 


sst_seg 


106 


1024 


stack 0 data 


107 


10240 


stoek_seg 


110 


1024 


sys__info 


111 


1024 


syserr__data 


112 


1024 


syserr_log_data 


113 


64512 


syserr_log_laurel 


114 


10240 


syserr_log_hardy 


115 


18432 


tc___data 


116 


1024 


active_all_rings_data 
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117 


3072 


active_hardcore_data 




121 


9216 


as t_lock_me ter_seg 




143 


34816 


dbm_seg 




144 


3072 


dir_lock_seg 




146 


2048 


dm_j oumal_se^ 




147 


0 


fnp_dump_seg 




160 


3072 


iojpage__table_seg 




161 


0 


ioat 




163 


1024 


Ivt 




175 


0 


salv_dir__space 




176 


1024 


salv_data 




177 


0 


salv_temp__dir 




200 


134144 


scavenger_data 




201 


65536 


str_seg 




202 


1024 


syserr__daemon_dseg 




203 


2048 


syserr daemon pds 




204 


2048 


syserr_daemon_s tack 




210 


2048 


temp la te_pds 




211 


63488 


tty__area 




212 


77824 


tty_b\if 




213 


2048 


tty tables 




214 


6144 


vtoc_buffer__seg 




221 


13312 


>pdd> zz22Z2zbBBBBBB>stack_l 




224 


19456 


>pdd> zz2ZzzzbBBBBBB>stack__4 




231 


14336 


>pdd 




233 


2048 


>pdd> zzzzzzzbBBBBBB 




273 


14336 


>pdd> 2zzzzzzbBBBBBB> BBBJPMnkNPCxqj , 


area. linker 


323 


46080 


>pdd> zzzzzzzbBBBBBK> BBBJPMnkPBlniHx . 


area. linker 


331 


4096 


>pdd> zzzzzzzbBBBBBB> BBBJPMnkPFQWgB 




354 


1024 


>pdd> zzzzzzzbBBBBBB>pit_temp_ 




457 


11264 


>pdd> zzzzzzzbBBBBBB> BBBJPMnkWJXXxF . 


. area . ipc 


465 


0 


>pdd> zzzzzzzbiSJ5J5i5J513> BBBJPMnkWQkGkM. temp. 0465 


520 


2048 


>pdd> BLBDXhpbBBBBBB 




563 


2048 


>pdd> BMLDXhxBBBBBBB 




565 


1024 


>pdd> BNBDXhzbBBBBBB 




2014 


2048 


>pdd> BxBDbdFbBBBBBB 




2015 


2048 


>pdd> CZLDbcdBBBBBBB 




2017 


2048 


>pdd> CXbDbbnbBBBBBB 




2023 


2048 


>pdd> BmLDbcJBBBBBBB 
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Process 1, Idle . SysControl.a, ready (-elig he stk) 



Seg# Len Name 

0 1024 dseg 

72 8192 kst_seg 

74 1024 pds 

75 8192 prds 

Process 2, Idle.SysControl.b, ready (-elig he stk) 

Seg# Len Name 

0 1024 dseg 

72 8192 kst__seg 

74 1024 pds 

75 7168 prds 

Process 3, Idle . SysGontrol , e , ready (-elig he stk) 

Seg# Len Name 

0 1024 dseg 

72 8192 kst_seg 

74 1024 pds 

75 3072 prds 

Process 4, Idle. SysGontrol. d, ready (-elig he stk) 

Seg# Len Name 

0 1024 dseg 

72 8192 kst_seg 

74 1024 pds 

75 7168 prds 

Process 5, Idle.SysControl.e, ready (-elig he stk) 

Seg# Len Name 

0 1024 dseg 

72 8192 kst_seg 

74 1024 pds 

75 7168 prds 
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Process 6, Demers . Flower . a , running (-nin he pp moddir) 



Seg# 


Len 


Name 


0 


1024 


dseg 


72 


1024 


kst_seg 


74 


2048 


pds 


75 


8192 


prds 


220 


11264 


>sll>stack_0 . 035 


221 


3072 


>pdd> BLbDbdKBBBBBBB>stack_l 


222 


3072 


>pdd> BLbDbdKBBBBBBB>stack_2 


224 


7168 


>pdd> BLbDbdKBBBBBBB>stack 4 


237 


10240 


>pdd> BLbDbdKBBBBBBB> BBBJPNBqbbZbGF. area. linker 


254 


1024 


>pdd> BLbDbdKBBBBBBB>pit 


317 


2048 


>pdd> BLbDbdKBBBBBBB>process_search_segment_. 4 


330 


5120 


>pdd> BLbDbdKBBBBBBB> BBBJPNBqbjdQZd. area. linker 


332 


5120 


>pdd> BLbDbdKBBBBBBB> BBBJPNBqbkFBCb. area. linker 


Process 7 , 


Spratt .Hultics .m, running (-irun he pp moddir) 


Seg# 


Len 


Name 


0 


1024 


dseg 


72 


2048 


kst_seg 


74 


2048 


pds 


75 


7168 


prds 


220 


12288 


>sll>stack_0 . 016 


224 


38912 


>pdd> BdLDbbjBBBBBBB>stack_4 


237 


191488 


>pdd> BdLDbbjBBBBBBB> BBBJPNBmfbjNjK. area. linker 


304 


5120 


>pda> BdLDDDJ BBBBBBB> BBBJ PNBmrgJllCD . temp . 0 JUA- 


332 


6144 


>pdd> BdLDbbjBBBBBBB> BBBJPNBmfkwPFh. area. linker 


340 


5120 


>pda> BdLDoDj BBBBBBB> BBBJPNfimrlwdLcl. area, linker 


347 


2048 


>pdd> BdLDbbjBBBBBBB>process_search_segment_. 4 


361 


1024 


>pdd> BdLDbbj BBBBBBB> BBBJPNBmf pWzmP . temp .0361 


431 


1024 


>pdd> BdLDbbj BBBBBBB> BBBJPNBmgFcGQh. temp. 0431 


432 


1024 


>pdd> BdLDbbj BBBBBBB> BBBJPNBmgQmfch. temp . 0432 


433 


0 


>pdd> BdLDbbj BBBBBBB> BBBJPNBmgpLfKD. temp. 0433 


Process 8 , 


Le.Mx.a, waiting (-elig he stk) 


Seg# 


Len 


Name 


0 


1024 


dseg 


72 


2048 


kst_seg 


74 


2048 


pds 


75 


7168 


prds 


220 


10240 


>sll>stack_0.022 


221 


3072 


>pdd> BkBDbcWbBBBBBB>staek_l 


222 


4096 


>pdd> BkBDbcWbBBBBBB>stack_2 


224 


41984 


>pdd> BkBDbcWbBBBBBB>staek_4 
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04/05/85 dump 



BCE dump Coimnand 



Syntax as a coimnand: 

dump {macro_keyword) { -process__group segment_option 
{ . . . segment_options } } { -control_args ) 



Function: produces a diagnostic dionp of system memory and tables after 
a hardware or software failure, for later analysis. The dump is 
produced by copying binary images of segments and directories into the 
DIMP partition of the disk described by the part dump config card. 
Arguments to the dxxmp command specify which processes are to be 
examined and which segments from those processes are to be dumped. 
(See "Notes'* for a general purpose command line.) This command is 
valid at all BCE command levels. 



Arguments : 
macro__keyword 

specifies one of the following default group of processes and 
segments to dump, 
-brief, -bf 

is equivalent to -run he pp mod dir 
-long, -Ig 

is equivalent to -all wrt 
-standard, -std 

is equivalent to -run he pp mod dir -elig he stk -inzr he stk 



process_group 

specifies a group of processes to be considered for dumping. The 
segments that get dumped for processes in this group are specified 
by segment options that follow the process group keyword. Allowed 
groups are: 
-all 

all processes 
-eligible, -elig 

all running and eligible processes (processes being considered 

for nanning) 
-initializer, -inzr 

the initializer process (first apte entry) 
-running, -run 

processes running on a processor (apte. state - running or 
stopped) 



segment_option 

specifies a class of segments to be dtimped for the group of 
processes specified by the process group keyword. Segment classes 
are: 

directories , dir 

directory segments (aste.dirsw - "l''b) 



F88, 1-6 



hardcore, he 

the pds, kst, dseg and ring 0 stack for the process (es). If a 
process is running, this also dumps the prds for the processor in 
question, 
modif ying_dirs , moddir 

directory segments (aste.dirsw - "l"b) which were being modified 
at the time of the crash (dir. modify "0"b) 



per__process , pp 

the segments contained within the process directory of the 

process (es) (aste.per_jprocess = '*l"b) 
stacks, stk 

all stack segments in the process (es) not already dumped by the 
he or pp keywords, 
writeable, wrt 

all segments to which the process (es) have write access. This 
keyword produces a very large dump. 

Writable ring zero segments (system data bases) other than 
directories are dumped regardless of what keywords are specified. 

Prefixing a segment option with a circumflex ('') reverts an earlier 
occurence of the given segment option. Thus, you can turn on a 
macro_keyword and turn off a specific segment option within it. 

Control arguments: 
-bee 

dumps BCE itself (the dumper). 
- crash 

specifies that BCE is to dump the saved Multics image, 
-drive, -dv drive_name 

places the dump into the diunp partition of the specified drive 

instead of the drive listed on the PART DXJMP card, 
-dump # 

changes the dump number to a desired value. By default, dumps are 
assigned numbers sequentially. 

-force, -fe 

places the diunp into the DUMP partition without querying you first, 
even if this means that an existing dump which hasn't been copied 
will be overwritten. If this control argument is not used, the dump 
command asks you if the existing dump should really be overwritten 
before it overwrites it. 
-no_sstnt 

disables sst_names_ generation. If sst_names__ generation is enabled 
for the system ( by the astk parm in the conf ig deck) , this control 
argument has no effect. 



-sstnt 

causes the segment sst_names_ (the sst name table) to be filled in 
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and included in the dump. The segment sst_names_ provides a name 
for each ASTE in the system. This information is of use to dump 
analysis programs. If sst_names_ generation is enabled for the 
system (by the astk parm in t±e conf ig deck) , this control argument 
has no effect. This is the default. 



Notes: For general purpose dump analysis, the command line: 

dump -std 
which is equivalent to 

dump -run he pp mod dir -elig he stk -inzr he stk 

should give the user all of the useful processes and segments (to 
produce a smaller dump, remove the "mod dir" keyword). For simplicity, 
and to remove the possibility of operator error, this command line 
should be placed into a BCE exec__com, either by itself or in a site 
supplied crash exee__com. 

The dump command examines the active process table entries (apte) 
within the specified image. For each entry, the criteria specified 
through the keywords are used to decide if any segments from this 
process are to be dumped. If any segments are to be dxamped, the 
segment options are applied to each segment active within that process 
to decide whether or not they should be dumped. As each process is 
dumped, the dtamp command will produce an output line showing the apte 
number and the dbr value for the process. After scanning all apte 
entries, if the process in control when Hultics crashed was not one of 
the processes dumped, it is dimtped with a status line showing an apte 
number of zero. This process is diimped with the running and 
initializer segment options. 

A counter and a valid flag are kept within the DX3MF partition. When a 
dump is placed into the partition, the valid flag is set. It is reset 
when the dump is copied out during Multics service (by the copy_dump 
exec command) . If the dump in the partition has not been copied, the 
dump command will ask you if it should be overwritten. You can avoid 
this query by specifying the -force (-fc) control argument. 

The dump command provides a severity indicator, indicating the 
successful of its operation. This indicator may be obtained with the 
severity command/active function. The interpretation of the severity 
status is : 

3 - the dump request was never called. 

2 - the dump request was entered, but never completed. 

1 - the dump was aborted because the DUMP partition contains 

an older dump. 
0 - the dump was successfully generated. 
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MOLTICS FAULT TYPES 



# Name 



0 Shutdown 

1 Store 

2 MME 1 

3 Fault Tag 1 

4 Timer Runout 

5 Command. 

6 Derail 

7 Lockup 

8 Connect 

9 Parity 

10 Illegal Procedure 

11 Op Not Complete 

12 Startup 

13 Overflow 

14 Divide Check 

15 Execute 

16 (DFO) Segment 

17 (DFl) Page 

18 Directed Fault 2 

19 Directed Fault 3 

20 Access Violation 

21 MME 2 

22 MME 3 

23 MME 4 

24 (FT2) Linkage 

25 Fault Tag 3 

26 Unassigned 

I ui.ia.>90 j.^i.i.cu- 

28 Unassigned 

29 Unassigned 

30 Unassigned 

31 Trouble 
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FAULTS BY CATEGORY 



FAULTS THAT ALtfAYS CRASH SYSTEM 

# Fault Name 

26 Unassigned 

27 Unassigned 

28 Unassigned 

29 Unassigned 

30 Unassigned 

15 Execute 

FAULTS USED INTERljlALLY BY SUPERVISOR 

# Fault Name 

4 Timer Runout 

8 Connect 

20 Access Violation (Ring Alarm) 

IKPLICIT REQUESTS FOR SUPERVISOR SERVICES 

# Fault Name 

17 (DFl) Page 

16 (DFO) Segment 
24 (FT2) Linkage 

20 Access Violation (boundsfault , etc.) 
FAULTS THAT ALWAYS INDICATE HARDWARE fROBLESCS 

# Fault Name 

0 Shutdown 

11 Op Not Complete 

12 Startup 

9 Parity 

1 Store 

FAULTS THAT ALS7AYS INDICATE HARDWARE OR SOFTWARE PROBLEMS 

# Fault Name 

31 Trouble 

18 Directed Fault 2 

19 Directed Fault 3 
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FAULTS THAT CAN BE GEIilERATED BY USER 

# Fault Name 

20 Access Violation 

5 Command 

6 Derail 

2 MME 1 

3 Fault Tag 1 

7 Lockup 

10 Illegal Procedure 

13 Overflow 

14 Divide Check 

21 MME 2 

22 MME 3 

23 MME 4 

25 Fault Tag 3 
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FAULT vscaoL n humesical <»der 



f 




SCU 


s^ocfid 


I az 




Handler 






0 




SCtl 


500,* 


-> 


pds$fim_data (70|60) 




tra 


400,* 


-> 


£im$onc start sfaut entry (34|l4) 


1 


Store 


scu 


502,* 


-> 


pds$signal_data (70 | 140} 




tra 


402,* 


-> 


£liii$slgnal entry (34 1 300) 


2 


MME 1 


SCU 


504.* 


-> 


pds$signal_daca (70 | 140) 




tra 


404,* 


-> 


£lin$signal entry (34 1 300) 


3 


Fatilt Tag 1 


scu 


506,* 


-> 


pds$signal_data (70 | 140) 




tra 


406,* 


-> 


fiin$signal entry (34 1 300) 


4 






510,* 


-> 


prds$£lra_data (71 | 160) 




tra 


410,* 


-> 


wired £iiii$tiiner runout (34 1 2324) 


5 




scu 


512.* 


-> 


pds$fim_data (7o|60) 




tra 


412,* 


-> 


£iin$prliiiary £ault entry (34 1 404) 


6 


Derail 


scu 


514,* 


-> 


pds$signal_data (70 | 140) 




tra 


414,* 


-> 


fiin$drl entry (34|30) 


7 


Loclcup 


scu 


516,* 


-> 


pds$slgnal_dai:a (70 1 140) 




tra 


416,* 


-> 


£iBi$signal entry (34 1 300) 


3 


Con&ect 




520,* 


-> 


pzds$£lm_data (71 | 160) 




tra 


420,* 


_^ 




9 


Pairl^y 




522 * 


-> 


pdsSfini_data (70|60) 




tra 


422,* 


— > 




10 






524,* 


-> 


pds$signal_data (70 1 140) 




tra 


424,* 












526,* 


-> 


pds$£iiii_dat:a (70|60) 




tra 


426,* 






12 






530 * 


-> 


pds$fiin_data (70 [60) 




tra 


430,* 




f i ini^onc start sbut entiry (34|l4) 


13 


Ova ^1^1 
WW £X ^ w w 




532 f* 


-> 


pds$signal_data (70 | 140) 




tra 


432,* 




n I ni*7>s xj^iiaj» enuxy juu^ 


14 


Divide Cbeclc 




534,* 


-> 


pda$slgnal_dai:a (70 1 140) 




tra 


434,* 






15 


Sxecu'te 




536 * 


-> 


pzds$sys_troubIe_data (71 | 


240) 


tra 


436,* 






16 


( DFO ) Se^nent^ 




540 * 


-> 


pds$£lin_daca (7o|60) 




tra 


440,* 




JL 1 iifcpyji liHiiMfcjr j»mx i» vuwfjr 


17 


(DFl) Page 




542,* 


-> 


pds;^^e_fault_data (70|0) 




tra 


442,* 






18 


Directed Faulc 2 




544 * 


-> 


pds$signal_data (70 | 140) 




tra 


444,* 






19 






546, * 


-> 


pds$signal_daca (701140) 




tra 


446,* 




X 1 m«?a j,j^iia A enuxy ^ohi juu/ 


20 






550 * 


-> 


pds$£im_dat:a (70|e0) 




tra 


450,* 




£izn$access violation entry (34 10) 


21 


MME 2 




552 * 


-> 


p<ls$signal_da«a (70 1 140) 




tra 


452,* 




X 1 mija igna i ezLuxy jui/^ 


22 






554 * 


-> 


pds$slgnal_data (70 | 140) 




tra 


454,* 






23 


MME 4 




556 * 


-> 


pdsS3ignal_data (70 | 140) 




tra 


456,* 




xuDvaxgnax enuxy ^jhi juu^ 


24 






560 * 


-> 


pds$£im_data (70|60) 




tra 


460,* 




fiin^prlnifljLjr £ault entry C34|404) 


25 


Faulc Tag 3 


scu 


562,* 


-> 


pds$slgnal_dat:a (70 1 140) 




tra 


462,* 


-> 


fiiii$signal_entry (34 1 300) 


26 


Unas signed 


scu 


564,* 


-> 


prds$sy3_troubLe_data (7l| 


240) 


tra 


464,* 


-> 


wired_f im$uneatp_f ault (34 1 2310 ) 


27 


Unas signed 


scu 


566,* 


-> 


prds$sys_trouble_daCa (71 | 


240) 


tra 


466,* 


-> 


wired_f ii!i$tjne3cp_f ault ( 34 1 2310 ) 


28 


Uxiassi^ed 


scu 


570,* 


-> 


prds$sya_trQubLe_data (71 | 


240) 


tra 


470,* 


-> 


wired_f im$unejcp_£ault (34 1 2310) 


29 


Unas signed 


sou 


572,* 


-> 


prds$sys_trouble_data (71 | 


240) 


tra 


472,* 


-> 


wired_f in»$unexp_f atilt ( 34 1 2310 ) 


30 


Unas signed 


scu 


574,* 


-> 


prds$sys_trottbIe_data (71 1 


|240) 


tra 


474,* 


-> 


wired__f imStmexp_£ault ( 34 j 2310 ) 


31 


Trouble 


scu 


576,* 


-> 


pds$£lm_data (70|60) 




tra 


476,* 


-> 


£liD$priffiary_£auIt_entry ( 34 1 404 ) 
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FAULT VECXORZ BY CUEGORY 



FMXLTS TBXS AL1UZS CRASB. SY5IEM 



# 


Fault Hame 


SCU 


stored at 


Handler 












26 


Unassigned 


scu 


564,* 


-> pxds$sys_trouble_data (71 | 240) 


tra 


464, 


* 


-> 


wired_£i0i$unexp_£ault 


(34| 


|2310) 


27 


Unas signed 


SCU 


566,* 


-> prds$sys_trouble__data (71 1 240) 


tra 


466, 


* 


-> 


wired_f iin$tmexp_f ault 


(34 1 


|2310) 


28 


Unassigned 


scu 


570,* 


-> prds$s7s_trouble_data (71 | 240) 


tra 


470, 


* 


-> 


wired_£im$unexp_£ault 


(34 j 


|2310) 


29 


Csassigned 


scu 


572,* 


-> prds$s7S_trouble_data (71 j 240) 


tra 


472, 


* 


-> 


wlred_£iin$unexp_£ault 


(34] 


|2310) 


30 


Unassigned 


scu 


57A,* 


-> prds$3ys_trouble_data (71 | 240) 


tra 


474, 


* 


-> 


wtred_f im$unexp_fault 


(34 


|2310) 


15 


Execute 


scu 


536,* 


-> prds$s7s_trouble_data (71 | 240) 


tra 


436, 


* 


-> 


wired_£iin$xec_£aiilt ( 34 1 2274 ) 



FAULTS USED IHTKRHAT.LY BY SUPERVISOR 



# Fault Name 
4 Timer Runout 
8 Connect 
20 Access Violatloi 
(Ring Alarm) 



SCU stored at 

scu 510,* -> prds$£im_data (71 | 160) 
scu 520,* -> prdsS£im_data (71 | 160) 
scu 550,* -> pds$£lffl_data (70|60) 



Handler 

tra 410,* -> wired_£ini$tin»r_runout (34 1 2324) 

tra 420,* -> prds$fast_connect_code ( 71 | 1054) 

tra 450,* -> £lm$access_violation,_entr7 (34 10) 



IM^CIT SBQDBSK FOR SDFEK9IS0R SERVZCBS 



# Fault Hame 

17 (DFl) Page 

16 (DFO) Segment 

24 (FT2) Linkage 

20 Access Violation 



SCU stored at 

scu 542,* -> pds$page_£ault_data (70 |o) 
scu 540,* -> pdsSfijBjdata (70j60) 
scu 560,* -> pds$fim_data (70|60) 
scu 550,* -> pds$fim_data (70|60) 



Ebmdler 

tra 442,* -> page_fault$pase_fault (44 j 1062) 
tra 440,* -> f im$primary_fault_entry (34 | 404) 
tra 460,* -> fim$primary_fault_entry (34 j 404) 
tra 450,* -> f im$access_violation_entry (34 10) 



( boimdsfault , e.g.) 



FAULTS raa ALKAZS IHDICAZE SUQXURE FRtmSMS 



# 


Fault Name 


SCU stored 


at 




Handler 








0 


Shutdown 


scu 500,* 


-> pd3$fim_data (70 


|60) 


tra 


400,* 


-> 


f im$onc_start_shut_entry (34 | 


il4) 


11 


Op Not Complete 


scu 526,* 


-> pds$fim_jdata (70 


1 50) 


tra 


426,* 


-> 


£im$onc_start_3imt_entry (34 1 


|l4) 


12 


Startup 


scu 530,* 


-> pds$fim_data (70 


|60) 


tra 


430,* 


-> 


fim$onc_start_sbut_entry (34] 


|14) 


9 


Parity 


scu 522,* 


-> pds$fim_data (70 


160) 


tra 


422,* 


-> 


fim$parity_entry (34 | 124) 




1 


Store 


scu 502,* 


-> pds$signaljdata 


(70 1 140) 


tra 


402,* 


-> 


£im$signal_entry (34 | 300) 





FAULTS THAI ALHAZS IHDICAXB HWmHAIBK OR SOFTWffiB fSOBLEMS 



# Fault Name 

31 Trouble 

18 Directed Fault 2 

19 Directed Fault 3 



SCU stored at 

scu 576,* -> pds$fim_data (7o|60) 
scu 544,* -> pds$signal_data (70 j 140) 
scu 546,* -> pds$si9ial_data (70 | 140) 



Handler 

tra 476,* -> f im$primary_fault_entry (34 | 404) 

tra 444,* -> £im$s ignal_entry (34 | 300) 

tra 446,* -> fim$signal_entry (34 | 300) 



F88, 2-5 



FAULTS TBAT CtX BE 6EBERAIED BT USER 





Faulc Name 


SCO 




at 




20 


A^^AjKV VI n1 &^ f nn 




550 * 


-> 


pds$fliD_data (70|60) 




5 






512 * 


-> 


pda$fiia_data (70|60) 






Dcsail 




514,* 


-> 


pds$signal_data (70 | 


140) 


2 


IMS 1 




504,* 


-> 


pds$signal_data (70 | 


140) 


3 






506,* 


-> 


pds$signal_data (70 { 


140) 


7 






516,* 


-> 


pds$signal_data (70 


140) 


10 


Illegal Procedure 


seu 


524,* 


-> 


pds$signal_data (70 


140) 


13 


Overflow 


scu 


532,* 


-> 


pds$sigzial_data (70 


140) 


14 


Divide Check 


seu 


534,* 


-> 


pds$signal_data (70 


140) 


21 


WE 2 


seu 


552,* 


-> 


pds$signal_data (70 


140) 


22 


MME 3 


scu 


554,* 


-> 


pds$sigiial_data (70 


140) 


23 


MME 4 


scu 


556,* 


-> 


pds$sigiial_data (70 


140) 


25 


Fault Tag 3 


seu 


562,* 


-> 


pds$signal_data (70 


140) 



Handler 






tra 


450,* 


-> 


£isB$aecess violation entry (34 |0) 


tra 


412,* 


-> 


f iin$priinary fault entry (34 1 404) 


tra 


414,* 


-> 


fim$drl entry (34|30) 


tra 


404,* 


-> 


£iin$signal entry (341300) 


tra 


406,* 


-> 


fiin$slgnal entiy (34 1 300) 


tra 


416,* 


-> 


floi$slgnal entry (34 1 300) 


tra 


424,* 


-> 


£iin$signal_entry (34 1 300) 


tra 


432,* 


-> 


fim$signal_entry (34 | 300) 


tra 


434,* 


-> 


fijn$signal_entry (34 1 300) 


tra 


452,* 


-> 


£im$signal_entry (34(300) 


tra 


454,* 


-> 


fim$signal_entry (34 | 300) 


tra 


456,* 


-> 


fim$signal_entry (34 1 300) 


tra 


462,* 


-> 


fim$signal_entry (34 | 300) 
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PROHIBITED FAULTS 



Systroiable 



Code Reason 

1 Page fault vhile on prds 

2 Fault/Interrupt while on prds 

3 Fault in idle process 

4 Fault/Interrupt with PTL set 

5 Unrecognized fault 

6 Unexpected fault 

7 Execute fault by operator 

8 Out -of- Segment -Bound on prds 

9 Fault while in masked environment 

10 Fault while in bound_interceptors 

11 Ring 0 derail 
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Crash Sequence for Type 1 Crash: Prohibited Fault 

CPU A (Bootload CPU) CPU B CPU C 



«FAULT» 

fault vector scu/tra 
handler 

fimutilScheckfault 

s c s $ sy s__t r cub le__pending- - N 

scs$trouble_j)rocessid» 

PROCESSID 
cioc <CPU B> 
STOP 
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Crash Sequence for Type 1 Crash: 

CPU A (Bootload CPU) CPU B 



Prohibited Fault (continued) 

CPU c 



«CONNECT from CPU B » 



«CONNECT from CPU B» 

p r ds $ f as t_c onne c t_c o de 

test scs$sys_tro\ible_j)ending 

wi redf im$ connec thandler 
store MCs in prds$fim_data 



prds$fast_connect_code 

test scs$sys__troublejpending 

wiredf imSconnecthandler 
store MCs in prds$fim_data 

sys_trouble 

if scs$trouble__flags = 0: 
scs$trouble_flags - 

scs$processor 
cioc <all other CPUs> 
copy MCs from prds$fim_data 

to prds$sys_trouble_data 
scs$processor bit 1 =* 0 
scs$trouble__dbrs(l) - DBR 
test scs$bos_processor__tag 
STOP 



sys_trouble 

test scs$trouble_flags 
copy MCs from prds$£iin data 

to prds$sys_trouble_data 
scs$processor bit 0 =- 0 
scs$trotible_dbrs(0) - DBR 
test scs$bos_j)rocessor__tag 
inhibit lockup fault 
loop until scs$processor=>0 



if scs$sys__trouble_j>ending < 0: 

make flagbox message 
loop 1 second for all I/O 

to complete 
change derail fault vector 
execute drl instruction 



«CONNECT from CPU B» 

prds$fast_connect_code 

test scs$sys_trouble_pending 

wired_f imSconnectJhandler 
store MCs in prds$f im__data 

sys_trouble 

test scs$trouble_flags 
copy MCs from prds$f im_data 

to prds$sys_trouble_data 
scs$processor bit 2=0 
scs$trouble_dbrs(2) = DBR 
test scs$bos_j)rocessor_tag 
STOP 



BOS/BCE 

print flagbox message 
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Typical Dump Events for Type 1 Crash: Prohibited Fault 



Event 

DRL 

CON 

CON 

CON 

Fault 



CPU 



MC location 



Bootload Dump Header (DREGS) 

Non- prds$fim__data 6t 

trouble prds$sys_trouble_data 

Non- prds$f im__data & 

trouble prds$sys_trouble__data 

Trouble prds$f im_data & 

prds $ sy s__troub le__dat a 



Trouble PR2 in 

prds$sys_trouble_data 



Context /significance of MCs 

sys_trouble j 221 

Where executing when told 
to stop 

Where executing when told 
to stop 

fim__util|72 (cioc/dis in 
check_fault) . PR2 -> MCs 
for prohibited fault 

Prohibited fault that 
caused crash 
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Crash Sequence for Type 2 Crash: Syserr 



CPU A (Bootload CPU) 



CPU B 



hardcor g^ prnfrrain 

call syserr with code 1 
svserr 

make sure stack is wired 
svserr real 

print message on console 
put message in syserr log 

pmut Sbceandre turn 

scs $ sy s_tr oijQ5le_pending- 

scs$processor 
scs$trouble_j)roGessid- 

PROCESSID 
cioc <CPU B> 
STOP 
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Crash Sequence for Type 2 Crash: Syserr (continued) 
CPU A (Bootload CPU) CPU B CPU C 



«CONNECT from CPU B» 



«CONNECT from CPU B 

prdsSf ast_connect_code 

test scs$sys_trouble_pending 

wired_fim$connect_handler 
store MCs in prds$fim_data 



prds$fast_conneet_code 

test scs$sys_trouble_pending 

wiredf imSconnecthandler 
store MCs in prds$f im__data 

sys_trouble 

if scs$trouble_flags — 0: 
scs$trouble_flags = 

scs$processor 
cioc <all other CPUs> 
copy MCs from prds$f im_data 

to prds$sys_trouble_data 
scs$processor bit 1-0 
scs$trouble__dbrs(l) - DBR 
test scs$bos_processor_tag 
STOP 



systrouble 

test scs$trouble_flags 

copy MCs from prds$f im__data 

to prds$sys_trouble_data 
scs$processor bit 0-0 
scs$trouble_dbrs(0) - DBR 
test scs$bosjprocessor_tag 
inhibit lockup fault 
loop until scs$processor=0 



test scs$sys_trouble_pending 
loop 1 second for all I/O 

to complete 
change derail fault vector 
execute drl instruction 



«C0NNECT from CPU B» 

pr ds $ f as t_conne c t_c o de 

test scs$sys_trouble_pending 

wired_f im$connect_handler 
store MCs in prds$f im_data 

sys_trouble 

test scs$trouble_flags 
copy MCs from prds$f im_data 

to prds$sys_trouble_data 
scs$processor bit 2=0 
scs$trouble_dbrs(2) = DBR 
test scs$bos_processor_tag 
STOP 



BOS/BCS 
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Typical Dump Events for Type 2 Crash: Syserr 



Event 


CPU 


DRL 


Bootload 


CON 


Non- 




troiible 


CON 


Non- 




troxible 


CON 


Trouble 



Syserr 
Message 

Syserr 
Message 



MC location 



prds$fim_data & 
prds $ sy s__tr oub le_data 

prds$fim_data & 
prds$sys_troiible_data 

prds$£im_data & 
prds $ sy s_tr oub le__da ta 



Context /significance of MCs 

sys__trouble 1 221 

IJhere executing when told 
to stop 

Where executing when told 
to stop 

pmut|315 (cioc/dis in 
bce_and_retum) ; PR6 -> 
stack where syserr called 

Multics not in operation 



Message from syserr call 
that crashed the system 



F88, 3-7 



Crash Sequence for Type 3 Crash: EXECUTE Fault 



CPU A (Bootload CPU) 



CPU B 



CPU C 



«CONNECT from CPU B» 

prds$fast_connect_code 

test scs$sys_trouble_pending 

wir e d_f i m$ c onnec t_handl er 
store MCs in prds$fim_data 

sys_trouble 

test scs$troiible_flags 
copy MCs from prds$f im_data 

to prds$sys_trouble_data 
scs$processor bit 0-0 
scs$trouble_dbrs<0) - DBR 
test scs$bos_processor_tag 
inhibit lockup fault 
loop until scs$processor»0 



test scs$sys_trouble_j)ending 

make flagbox message 
loop 1 second for all I/O 

to complete 
change derail fault vector 
execute drl instruction 



«EXECUTE FAULT» 

fault vector scu/tra 

wired_fim$xec fault 
store MCs in 

prds$sys__trouble_data 
scs$sys_trouble_pending— 7 

sys_trouble 

if scs$trouble_flags =- 0: 
scs$trouble_flags - 

scs$processor 
cioc <all other CPUs> 
copy MCs from prds$f im_data 

to prds$sys_trouble_data 
scs$processor bit 1—0 
scs$trouble_dbrs(l) - DBR 
test scs$bos_processor__tag 
STOP 



«C0NNECT from CPU B» 

prds$fastconnect_code 

test scs$sys_trouble__pending 

wiredf im$connect_handler 
store MCs in prds$f im_data 

sys_trouble 

test scs$trouble_flags 
copy MCs from prds$f im_data 

to prds$sys_trouble_data 
scs$processor bit 2-0 
scs$trouble_dbrs(2) - DBR 
test scs$bos_processor_tag 
STOP 



30S/BCE 

print flagbox message 



F88, 3-8 



Typical Dump Events for Type 3 Crash: EXECUTE Fault 



DUMP EVENTS SEQUENCE: 
Event CPU MC location 

DRL Bootload Dump Header (DREGS) 

CON Others 



CON 



EXF 



Others 



Button 
pushed 



prds$fini_data & 
prds $ sy s_troub le_data 

prds$fiin_data & 
prds $sy s_troub le_data 

pr ds $ sy s_tr oub le__data 



Context /significance of MCs 

sys_trouble | 221 

Where looping when told 
to stop; PR6 -> stack frame 

Where looping when told 
to stop; PR6 -> stack frame 

Where looping when EXF done; 
PR6 -> stack frame 
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Crash Sequence for Type 4 Crash: EXECUTE Switches 



CPU A (Bootload CPU) 



CPU B 



CPU C 



«MANUAL HALT» 



«MANUAL HALT» 



«EXECUTE SWITCHES» 
(XED iOGOO ' ) 

BOS/BCE 

print MANUAL RETURN TO BOS 
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T^ical Dump Events for Type 4 Crash: EXECDTE Switches 



DUMP EVENTS SEQUENCE: 

Event CPU MC location 

XED Bootload Dump Header (DREGS) 



Context /si|mificance of MCs 

PR6 -> stack frame 
of looping program 
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Stack, etc. B«foc« Call to B$B2 



Object Seg A [unique] .area. linker 



-> 


TEXT 






74 
75 


epp2 pr4|20,* 
t9p4 call_op 








DEFS 








I Ink 1 20 BSB2 
text) 12 A 


(PR4) 




20 
21 


LINKAGE 
777770000046 
000020000000 


+---> 
20 
21 


A's LINKAGE 

777770000046 

000020000000 




SYMBOL 








Object Seg B 






TEXT 








DEFS 








text 1 22 B 
text 1 64 B2 








LINKAGE 








SYMBOL 







F88, 



(PR7) stack 4 
I 

+--> 



LOT 



< + 



PR6 
I 

+--> 



HEADER 



initjproc_ 



A'a FRAME 
retptr-?????? 
entptr-400|a» 



Stack, etc. Duviot Call to B$B2 



[unique] .area. Linker (FR7) stack_4 





+ > 


TEXT 








+— > 


HEADER 














■ 









7'/ 


€tpp2 pr4 1 20 , * 














•76 


£jsp4 caIL op 
























1 n 1 li^^ji xro c 


KST/DSEG 




























LOT 














DEFS 




























* 




• 
































t*«iw1- lid A 








* 














LINKAGE 


■- 


A' a LINKAGE 


< — + 


* 












20 


777770000046 


20 


000425000043 


















21 


000020000000 




000064000000 




















* 




■ 










A's FRAME 


AOO 




+ 








+ 400 






retptr'400 1 76 




















entptr<'400|20 








SYMBOL 






























FR6 
1 




















+--> 


B's FRAME 










(PR4) 










retptr"?777?7 








B 


1 




+ 425 






entptro425 | 64 










+ > 


B's LINKAGE 


<--+ 












+ > 


TEXT 


/ 






















/ 






















/ 












425 







• 




/ / 


















DEFS 


/ / 


















text 1 22 B 


/ / 


















text 164 B2 


/ / 




















/ / 




















/ / 


















LINKAGE 


/ 




















/ 




















/ 




















/ 


















SYMBOL 
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Stack, ato. After Call to B$B2 



[ vinlqua ] . area . 1 inker 



KST/DSEG 



TEXT 






eoD2 pr4l20.* 






tsp4 call op 






DEFS 






link! 20 B4B2 






text 1 12 A 


(PR4) 




LINKAGE 


+ > 


A' a LINKAGE 


777770000046 


20 


000425000043 


000020000000 


21 


000064000000 


SYMBOL 






B 








/ 


B's LINKAGE 


TEXT 


/ 






/ 






/ 






/ / 




DEFS 


/ / 




text 1 22 B 


/ / 




text 1 64 B2 


/ / 






/ / 






/ / 




LINKAGE 


/ 






/ 






/ 






/ 




SYMBOL 







F88. 



(PR7) Stack 4 
I 

+--> 



LOT 



< + 



FR6 
I 

+--> 



HEADER 



lnlt_proo_ 



A's FRAME 
retptr«400 
en.tptr<B400 



B'e OLD FRAME 
retptr-?????? 
etttptx«425|64 



<-+ 



COMPILATION LISTING OF SEGMENT example 

Complied bys Multlcs PL/I Compiler, Release 28e, of February 14, 198S 
Compiled att Honeywell Multlcs Op. - System M 
Compiled on: 04/23/85 1108.7 mst Tue 
Options: table list 

1 /* format: style4, Indattr, lfthen,'^lndproe */ 
2 

3 example: proci 
4 

5 del autovar fixed bin (35) « 

6 del Intstatvar fixed bin (35) Int statlot 

7 del constant fixed bin (35) Int static options (constant) 

8 Init (4) I 

9 del ptrvar ptrt 

10 del 1 baaedstruct baaed (ptrvar), 

11 2 elementl fixed bin (35), 

12 2 element2 fixed bin (35) i 

13 del loa_ entry () options (variable) i 

14 allocate basedatructi 

15 basedatrucc.element2 - 27 i 

16 Intatatvar > Ot 
17 

18 do autovar 1 to 1000000] 

19 call Intproo (Intstatvar) t 

20 If divide (Intstatvar, 7, 0, 0) * 7 - Intstatvar then 

21 basedatruct.element2 

22 baaedstruct. elemeat2 + constant + Intstatvar i 

23 end I 

24 call ioa_ ("autovar - -^d, element2 - '^d, Intstatvar - ■^d", 

25 autovar, basedstruct.element2, Intstatvar)! 

26 return t 
27 

28 Intproc : proc (parm) t 

29 del parm fixed bin (35) i 

30 del 1 fixed bin (35): 
31 

32 1 ■ parmi 

33 parm - 1 -f mod (1, 6) + It 

34 end Intproc t 
35 

36 end exaniplei 
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SOURCE FILES USED IN THIS COMPILATION. 

LIME NUMBER DATE MODIFIED NAME PATEINAME 

0 04/23/85 1108.1 example. pll >udd>8S«>Jlh>F88>exainple.pll 
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NAMES DECLARED IN THIS C(»1PILATI0N . 



IDENTIFIER 



OFFSET 



LOG STORAGE CLASS DATA TYPE 



ATTRIBUTES AND REFERENCES 
(* indicates a aet context) 



NAMES DECLARED BY DECLARE STATEMENT. 



autovar 

baaedstruct 

constant 

eleinent2 

i 

intstatvar 
loa_ 
paxm 
ptirvar 



000100 automatic 
based 

000000 constant 
based 

000112 automatic 



fixed bln(35,0) 
structure 
fixed bin(35,0) 
fixed bin(35,0) 
fixed bin(35,0) 



000010 internal static fixed bln(35,0) 



000014 constant 

parameter 
000102 automatic 



entry 

fixed bin(35,0) 
pointer 



del 5 set ref 18* 24* 

level 1 unaligned del 10 set ref 14 

initial del 7 ref 20 

level 2 del 10 set ref 15* 20* 20 24* 

del 30 set ref 32* 33 33 

del 6 set ref 16* 19* 20 20 20 24* 

external del 13 ref 24 

del 29 set ref 28 32 33* 

dol 9 set ref 10 10 10 14* 15 20 20 24 



NAMES DECLARED BY EXPLICIT CONTEXT. 

example 000020 constant entry 

intproc 000123 constant entry 



external del 3 
internal del 28 ref 19 



NAMES DECLARED BY CONTEXT OR IMPLICATION, 
divide 

mod 



builtin function 
builtln function 



ref 20 
ref 33 



STORAGE REQUIREMENTS FOR THIS PROGRAM. 



Start 
Length 



Object 
0 

612 



Text 
0 

141 



Link 
174 
16 



Symbol 
212 
364 



Defs 
141 
33 



Static 
204 
2 



BLOCK NAME 

example 

intproc 



STACK SIZE TYPE 

112 external procedure 
internal procedure 



STORAGE FOR INTERNAL STATIC VARIABLES. 



WHY NONQUICK/WHO SHARES STACK FRAME 
la an external procedure. 

shares stack frame of external procedure example. 



LOC IDENTIFIER 
000010 intstatvar 



BLOCK NAME 
example 



STORAGE FOR AUTOMATIC VARIABLES. 



STACK FRAME 
example 



LOC IDENTIFIER 
000100 autovar 
000102 ptrvar 
000112 1 



THE FOLLOWING EXTERNAL OPERATORS ARE USED BY THIS PROGRAM. 
call_ext_out_desc return mod_fxl 

THE FOLLOWING EXTERNAL ENTRIES ARE CALLED BY THIS PROGRAM, 
ioa 



BLOCK NAME 
example 
exaniple 
intproc 



ext_entry 



alloc_based_storage 



NO EXTERNAL VARIABLES ARE USED BY THIS PROGRAM. 
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CONSTANTS 

000000 aa 000000000004 



000140 aa 



000000000006 



000001 



404000000043 



000002 



524000000054 



000003 



000003641100 



000004 


aa 141 


165 


164 


157 


auto 


000005 


aa 166 


141 


162 


040 


var 


000006 


aa 075 


040 


136 


144 


- 


000007 


aa 054 


040 


145 


154 


, el 


000010 


aa 145 


155 


145 


156 


emen 


000011 


aa 164 


062 


040 


075 


t2 •> 


000012 


aa 040 


136 


144 


054 




000013 


aa 040 


151 


156 


164 


Lnt 


000014 


aa 163 


164 


141 


164 


Stat 


000015 


aa 166 


141 


162 


040 


var 


000016 


aa 075 


040 


136 


144 


- '^d 



BEGIN PROCEDURE example 
ENTRY TO example 
example i pzoc i 



000017 


da 


000027200000 




000020 


aa 


000160 6270 00 


eax7 


000021 


aa 


7 00034 3521 20 


epp2 


000022 


aa 


2 01045 2721 00 


tsp2 


000023 


aa 


000000000000 




000024 


2s 


000012000123 





112 

pr7|28,* 
pr2|549 



allocate basedstructi 



000025 
000026 
000027 
000030 



aa 
aa 
aa 
aa 



000002 2360 07 
0 01403 7001 00 

777776 7100 04 
6 00102 2521 00 



Idq 
tsxO 
tra 
sprL2 



2,dl 
pro 1 771 
-2,1c 
pr6|66 



basedstruct.eLement2 " 27 i 



000031 aa 000033 2360 07 Idq 

000032 aa 2 00001 7561 00 stq 



27, dl 
pr2|l 



Intstatvar ~ 0i 



000033 aa 6 00044 3701 20 

000034 la 4 00010 4501 00 



epp4 

3tZ 



pr6 36, 
pr4l8 



do autovar - 1 to 1000000 i 



000035 



aa 000001 2360 07 Idq l,dl 



STATEMENT 1 ON LINE 3 



ext^entry 



STATEMENT 1 ON LINE 14 



alloc_based_storage 

000025 

ptrvar 

STATEMENT 1 OH LINE 15 



basedstruct . element2 
STATEMENT 1 ON LINE 16 



intstatvar 

STATEMENT 1 ON LINE 18 



000036 




6 00100 


7561 00 


stq 


pr6 


64 


autovar000037 aa OOODOO 


000040 


aa 


6 00100 


2361 00 


Idq 


pr6 


64 


autovar 


000041 


aa 


777742 


1160 04 


cmpq 


-30 


Ic 


000003 - 000003641100 


000042 


aa 


000031 


6054 04 


tpnz 


25, Lc 


000073 
















STATEMENT 1 ON LINE 19 






call 


Intproo 


(Intstatvar) i 






000043 


aa 


6 00044 


3701 20 


«pp4 


pr6 


36,* 




000044 


la 


4 00010 


3521 00 


epp2 


pr4 


8 


intstatvar 


000045 


aa 


6 00116 


2521 00 


spri2 


pr6 


78 




000046 


aa 


6 00114 


3521 00 


epp2 


pr6 


76 




000047 


aa 


004000 


4310 07 


fid 


2048, dl 




000050 


aa 


2 00000 


7571 00 


staq 


pr2 






000051 


aa 


000052 


6700 04 


tap4 


42, io 


000123 



nop 



0,du 



STATEMENT 1 ON LINE 20 
if divide (intstatvar, 7, 0, 0) * 7 ■ Intstatvar then 
basedstruct . eleinent2 ■ 

basedstruct . eLement2 -I- constant + intstatvar t 



000052 


aa 


6 00044 


3701 


20 


epp4 


000053 


la 


4 00010 


2361 


00 


Idq 


000054 


aa 


000007 


5060 


07 


div 


000055 


aa 


000007 


4020 


07 


mpy 


000056 


ia 


4 00010 


1161 


00 


cmpq 


000057 


aa 


000007 


6010 


04 


tnz 


000060 


aa 


6 00102 


3735 


20 


epp7 


000061 


aa 


7 00001 


2351 


00 


Ida 


000062 


aa 


000044 


7330 


00 


Ira 


000063 


aa 


000004 


0330 


07 


adl 


000064 


ia 


4 00010 


0331 


00 


adl 


000065 


aa 


7 00001 


7561 


00 


stq 



end) 



000066 


aa 


6 00100 


2351 


00 


Ida 


000067 


aa 


000044 


7330 


00 


Irs 


000070 


aa 


000001 


0330 


07 


adl 


000071 


aa 


6 00100 


7561 


00 


stq 


000072 


aa 


777746 


7100 


04 


tra 




pr6|64 
36 

l,dl 
pr6 I 64 
-26, io 



intstatvar 



Intstatvar 

000066 

ptrvar 

basedstruct . element2 



intstatvar 

basedstruct . element2 
STATEMENT 1 ON LINE 23 



call ioa_ ("autovar " '^d, element2 ■ 
autovar, basedstruct. eleroent2, 



autovar 
000040 
STATEMENT 
■^d, iKitstatvar - ^d", 
intstatvar) t 



1 ON LINE 24 



000073 


aa 


000 100 


100 404 


mir 


(ic),(pr),fill(000) 




000074 


aa 


777711 


00 0054 


deac9a 


-55 


44 


000004 - 141165164157 


000075 


aa 


6 00122 


00 0054 


de3c9a 


pr6 


82,44 




000076 


aa 


6 00122 


3521 00 


epp2 


pr6 


82 




000077 


aa 


6 00140 


2521 00 


spri2 


pr6 


96 




000100 


aa 


6 00100 


3521 00 


epp2 


pr6 


64 


autovar 


000101 


aa 


6 00142 


2521 00 


spri2 


pr6 


98 




000102 


aa 


6 00102 


3735 20 


epp7 


pr6 


66,* 


ptrvar 


000103 


aa 


7 00001 


3521 00 


epp2 


pr7 


1 


basedstruct . elenient2 


000104 


aa 


6 00144 


2521 00 


sprl2 


pr6 


100 




000105 


aa 


6 00044 


3701 20 


epp4 


pr6 


36,* 




000106 


ia 


4 00010 


3521 00 


epp2 


pr4 


8 


intstatvar000107 aa 



6 00146 2521 00 spri2 pr6|l02 
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000110 




777672 


3520 


04 


«pp2 


-70,1c 


000111 


ftft 


6 00150 


2521 


00 


3pcL2 


pr6 


104 


000112 


SLA 


777667 


3520 


04 


epp2 


-73, ic 


000113 


aa 


6 00152 


2521 


00 


sprL2 


pr6 


106 


000114 


aa 


6 00154 


2521 


00 


spri2 


pr6 


108 


000115 


aa 


6 00156 


2521 


00 


8prl2 


pr6 


110 


000116 


aa 


6 00136 


6211 


00 


eaxl 


pr6 


94 


000117 


aa 


020000 


4310 


07 


fid 


8192, dl 


000120 


la 


4 00014 


3521 


20 


•pp2 


pr4 


12,* 


000121 


aa 


0 00622 


7001 


00 


t5X0 


pro 


402 




return 1 












000122 


aa 


0 00631 


7101 


00 


tra 


pr0|409 



and axamplat 



BEGIN PROCEDURE intproc 
ENTRY TO intproo 
Intprooi proe (partn)) 



000123 


aa 


6 00104 


6501 


00 


sprL4 


pr6|68 


000124 


aa 


6 00106 


2521 


00 


aprl2 


pr6|70 




1 


>■ parmt 










000125 


aa 


2 00002 


2361 


20 


Idq 


pr2|2,* 


000126 


aa 


6 00112 


7561 


00 


9tq 


pr6|74 




parm •■ 1 + mod 


(1. 


6) + li 




000127 


aa 


000011 


3520 


04 


«pp2 


9,1c 


000130 


aa 


0 00704 


7001 


00 


tsxO 


pro 1 452 


000131 


aa 


000044 


7770 


00 


llr 


36 


000132 


aa 


000044 


7330 


00 


Ira 


36 


000133 


aa 


6 00112 


0331 


00 


adi 


pr6|74 


000134 


aa 


000001 


0330 


07 


adl 


l,dl 


000135 


aa 


6 00106 


3735 


20 


epp7 


pr6|70.* 


000136 


aa 


7 00002 


7561 


20 


stq 


pr7|2,* 



end intproc I 



000137 aa 6 00104 6101 00 rtcd 
END PROCEDURE intproc 
END PROCEDURE axample 



pr6i68 



000002 - 524000000054 



000001 - 404000000043 



ioa_ 

call_axt_out_d«ao 
STAtImENT 1 ON LINE 26 



return 

STATEMENT 1 ON LINE 36 



STATEMENT 1 ON LINE 28 



STATBfENT 1 ON LINE 32 



parm 
1 

STATEMENT 1 ON LINE 33 



000140 - 000000000006 
mod fxl 



1 



parm 

STATEMENT 1 ON LINE 34 



5:sfi^ 



azm 



azm: ? 

Available azm requests: 

absolute_address , absadr 
add_request__table, arqt 
apply, ap 
apte 

associativejnemory , am 
aste 

conf iguration_deck, cd 
display, d 
display_absolute , da 
events , ev 
history__regs , hregs 
list_dtonps , Isd 
list_processes , Isp 
machine__conditions , mc 
page__trace, pgt 
quit, q 
replace , rp 
sous 
sdw 

select_deadproc , sldp 
select_dump , sld 



select_process , sip 
search, srh 
segment_jiame , name 
segment_number , number 
set 

syserr__log, slog 
stack, sk 

traf f ic_control__queue , tcq 
value, V 

verify_associative_memory, vfam 

why 

help 

listjtielp , Ih 
list__requests , Ir 
abbrev, ab 
exec__com, ec 
do 
if 

answer 
execute , e 
ds 



Type ''list_requests'' for a short description of the requests, 



azm: Isd 



032885.1120.0.156 
041185.0001.0.160 

azm: ..asp dumps >dumps>old_dumps 

azm: Isd 
Dtjmps in >dumps: 

032885.1120.0.156 

041185.0001.0.160 
Dumps in >dumps>old_dumps : 

121284.0638.0.127 

121384.0832.0.128 

122084.0728.0.135 

030885.2239.0.151 

031585.1653.0.152 

031585.2158.0.153 

031885.1148.0.154 

031885.1515.0.155 

040385.0023.0.158 

040385.0120.0.159 



azm: sld 159 

ERF 159 in directory >dumps>old_dumps diimped at 04/03/85 



0120.6 mst Wed. 
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System- ID MRll.O Vers ion- ID 41-13 
Proc 0 DBR 6234350 running on cpu c Initializer .SysDaemon.z 



azm: d scs$trouble_j)rocessid 

Segno 25 boiind_hc_data_wired$scs 1 222 



222 



0 003000777777 



azm: slog -last 20 

There are 2 messages in syserr_data (segment #106) . 

0119.7 1479393 0 Multics not in operation; control process: Initializer. SysDaemon.z. 
Syserr messages from log partition: 



01: 


19 


:40 


1479390 


3 


emergency interrupt from FNP a: unknown faul\000 


01: 


19 


:39 


1479389 


3 


emergency interrupt from FNP a: unknown fault 


01: 


19 


:27 


1479388 


5 


ioijDaasked$interrupt: I/O error. 


01: 


19 


:18 


1479387 


0 


FNP a loaded successfully 


01: 


19 


:17 


1479386 


5 


ioi_masked$ interrupt: I/O error. 


01: 


19 


:02 


1479385 


5 




01: 


19 


:02 


1479384 


5 




01: 


19 


:02 


1479383 


5 




01: 


18 


:54 


1479382 


0 


Loading FNP a, >udd>SysAdmin>a>mcs7 . 2>6670a>a 7.2 


01: 


18 


:36 


1479381 


5 


ioi_masked$ interrupt: I/O error. 


01: 


18 


:31 


1479380 


4 


RCP: Unassigned prtd from Utility . SysDaemon.z 


01: 


18 


:30 


1479379 


0 


RCP: Detached prtd from Utility. SysDaemon.z 


01: 


18 


:28 


1479378 


3 


poll_mpc: I/O error on urpa: Parity error on I/O bus, 


01: 


18 


:26 


1479377 


0 


RCP: Attached prtd for Utility. SysDaemon.z 


01: 


18 


:26 


1479376 


4 


RCP: Assigned prtd to Utility. SysDaemon.z 


01: 


18 


:25 


1479375 


4 


RCP: Unassigned tapa_00 from Utility. SysDaemon.z 


01: 


18 


:25 


1479374 


0 


RCP: Detached tapa_00 from Utility. SysDaemon.z 


01: 


18 


:24 


1479373 


5 


poll_mpc: Polled mtpa. 


01: 


18 


:22 


1479372 


0 


RCP: Attached tapa_00 for Utility , SysDaemon.z 


01: 


18 


:22 


1479371 


4 


RCP: Assigned tapa_00 to Utility. SysDaemon.z 



data from c 



azm: help events -bf 

Syntax: events { -control_args} 

Function: Displays 'interesting events', in reverse chronological 
order, from an FDUHP. Those events considered to be interesting are 
described in 'notes'. 



Control Arguments: 
-last {N}, -It (N) 



•long, -Ig 

■time {NSECS}, -tm {NSECS) 



azm: ev -last 20 
Events from 04/03/85 



1:19:47.870284 



Time 


CPU 


Proc 


Event 




47.870284 


d 




Fault: 


DRL 


43.436614 


a 


8 


Fault: 


CON 


.436614 


b 


10 


Fault : 


CON 


.436516 


d 


6 


Fault: 


CON 


.436383 


c 


0 


Fault: 


CON 


.435683 


d 


6 


Interrupt: lOM A, Level 3 



Circumstances 

RTB Machine Conditions 
pr ds $ sy s__tr oub le__data 
pr ds $ sy s_tr oub le_da t a 
prds$sys_trouble_data 
prds$sys_trouble_data 
prds$ interrupt_data 
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.433229 


a 


8 


.433041 


a 


12 


.429753 






.426543 


a 


15 


.423070 


a 


11 


.422441 






.418303 


a 


7 


.418192 






.417694 






.416592 


a 


7 


.414092 


a 


14 


.413204 






.405858 


a 


11 


.402857 


a 


14 



to Running 

to Waiting for 000000231167 
to Ready 

to Waiting for 000000542415 



pds$page_fault_data 
to Waiting for 000000215021 



APTE at 5300 changed 
APTE at 10500 changed 
Connect to A 36 
APTE at 11700 changed 
APTE at 10300 changed 
Connect to A 29 

APTE at 5200 changed to Waiting for 000000332124 
Connect to B 28 
Connect to A 20 
Fault : DFl 

APTE at 11600 changed 
Connect to A 28 
Fault: DFl 
Fault: DFl 



pds$page__fault__data 
pds$page__fault_data 



azm: cd cpu mem 



cpu 
cpu 
cpu 
cpu 

cpu 
mem 



a 3 on 168 80. 2. 
b 4 on 168 80. 2. 
c 5 on dps8 70. 32. 
d 6 on dps8 70. 32. 
e 7 off dps8 70. 32, 
d 2048 . on 
on 
off 
4096 . on 



mem a 1024 . 
mem b 2048 . 
mem 



azm : scus 

Memory Configuration: 
Mem D 0 to 



7777777 



Mem C 40000000 to 57777777 



azm : tcq 
ELIGIBLE QUEUE: 
Proc DBR 

5 06060114 

0 06234350 

14 06174074 

7 06154234 

8 06154514 

15 06200214 

10 06157174 

11 06155774 

12 06077554 

9 06122354 

13 06166434 

6 06077754 



State Process ID CPU 
waiting 003600666666 
SYSERR LOG EVENT 0000000 
running 003000777777 c 
waiting 011600105645 
PAGE 215021 

waiting 005200105632 
PAGE 332124 

running 005300105633 a 
ready 011700105646 
running 010200105635 b 
waiting 010300105634 
PAGE 542415 

waiting 010500105624 
PAGE 231167 

ready 010100105614 
ready 011300105642 
running 005100105601 d 



Syserr Logger . SysDaemon. z 

Initializer . SysDaemon. z 
JNye.CSDUK.a 

Dist2.VIS.a 

Dumper . SysDaemon . z 
Backup . SysDaemon . z 
Retriever . SysDaemon . z 
Volume__Dumper . Daemon . z 

Cox. Mul tics .m 

Operator . Operator . a 

UNCP.CII-HB.a 

TR_Admin.TR.p 
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Isp 
















Proc 


0 


DBR 


6234350 

\J -J -J -J \J 


T^llTTTI 1 n P' 




on 


cpu 




Initializer . SysDaemon. z 


£ J. Vli^ 


1 


DBR 


52416 


rsfldy 


last 


on 


cpu 




Idle SvsControl a 




9 




52417 




last 


on 


cpu 


b 


Idle Svs Control b 


X J. \J\^ 


3 


DBR 


52420 




last 


on 


cpvi 




T dXe Svs CoTitT^o X c 


Proc 


4 


DBR 


52421 


rsady 


last 


on 


CT311 


d 


Idle . SysControl . d 


P^oc 


5 


DBR 


6060114 




last 


on 


cpu. 


b 


SvserrLoffser SvsDaemon . z 


PfOf* 


6 


DBR 


6077754 


^ 111 iitj^Aift 




on 


cpu 


d 


TR Admin TR tj 


PlTOC 


7 


DBR 


6154234 


wai ti np 


last 


on 


con 




Di7t2 VIS a 


£ J. 


g 


DBR 


6154514 










a 

CI 


1 r' *f ■ « ^ y O^CLdliW^* « « 


£ ^ 


9 


DBR 


6122354 














Ptoo 


10 


DBR 


6157174 






on 


cpu 


b 


Rett* Tftvet* SvsDaGinoTi z 

iLVw w JU JUC^ V W JU tt ^ T "JJ^Cfc will • 


Proc 


11 


DBR 


6155774 


waiting 


last 


on 


cpu 


a 


Volume_Duinper . Daemon . z 


Proc 


12 


DBR 


6077554 


waiting 


last 


on 


cpu 


a 


Cox.Multics.m 


Proc 


13 


DBR 


6166434 


ready 


last 


on 


cpu 


a. 


UNCP.CII-HB.a 


Proc 


14 


DBR 


6174074 


waiting 


last 


on 


cpu 


a 


JNye.CSDUK.a 


Proc 


15 


DBR 


6200214 


ready 


last 


on 


cpu 


a 


Backup . SysDaemon . z 


azm: 


sip 1 

















Process 1, Idle . SysControl . a , DBR 52416 

azm: sip [d scs$troublejprocessid] 

Process 0, Initializer. SysDaemon. z, DBR 6234350 

azm: mc -pds 

Machine conditions from pds$page_fault_data: 
(DFl) Page Fault (43) 

PR6 (sp) - 230 1 35500 >sll>stack_0 . 027 ) 35500 
SCU Data: 

By: 42 1 3121 bound_library_wired_$formline_|25 

Ref: 230 1 36107 >sll>stack_0. 027 1 36107 

On: cpu c (#2) 

Indicators : zero , '^bar 

APU Status: sdwamm, sd-on, pt-on, ptw 

Instructions : 

16700 6 00407 7551 00 sta pr6|407 

16701 6 00407 7551 00 sta pr6|407 
Fault Register: 000040000000 ($CON D) 

MC Fault Time: 85-04-03 01:19:42.461292 mst Wed (113442703553566554) 
Setting Temporary pointers from 71|0. 

Machine conditions from pds$fim_data: 

Access Violation Fault (51) , Out of Segment Bounds 

PR6 (sp) - 230 j 7020 >sll>stack__0 . 027 1 7020 
SCU Data: 

By: 150 1 11213 bound_x25_mpx$x25_mpx| 10513 
Ref: 77777 1 15 >sll>stack__0.027 1 15 
On: cpu c (#2) 
Indicators : ''bar 

APU Status: sdwamm, sd-on, ptwamm, pt-on, fap 
Instructions : 

16700 7 00014 4501 00 stz pr7jl4 

16701 7 00014 4501 00 stz pr7|14 

MC Fault Time: 85-04-03 01:19:41.494596 mst Wed (113442703550026504) 
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Setting Temporary pointers from 71|60. 



Machine conditions from pds$signal_data: 

Access Violation Fault (51) , Out of Segment Boixnds 

PR6 (sp) - 23017020 >sll>stack_0. 027 | 7020 
SOU Data: 

By: 150 1 11213 boimd_x25jnpx$x25jiipx| 10513 
Ref: 77777 1 15 >sll>stack_0.027 1 15 
On: cpu c (#2) 
Indicators : "^bar 

APXJ Status: sdwamm, sd-on, ptwamm, pt-on, fap 
Instructions : 

16700 7 00014 4501 00 stz pr7|14 

16701 7 00014 4501 00 stz pr7|14 

MC Fault Time: 85-04-03 01:19:41.494596 mst Wed (113442703550026504) 
Setting Temporary pointers from 71 | 140. 

azm: mc -prds sys 

Machine conditions from prds$sys__trotible__data: 
Connect Fault (21) 

PR6 (sp) - 230 1 30000 >sll>stack_0 . 027 1 30000 
SGU Data: 

By: 44 1 315 boundjpriv_l$privileged_mode_ut 1 315 
Ref: 230 1 36107 >sll>stack_0. 027 1 36107 
On: cpu c (#2) 

Indicators: neg, cary, tro, "^bar 

APU Status: priv, sdwamm, sd-on, ptwamm, pt-on, fap 
CU Status: rfi, fif 
Instructions : 

16700 000314 6162 00 dis 314 interrupt inhibit 

16701 000000 2350 07 Ida 0,dl 
Fault Register: 000040000000 ($C0N D) 

MG Fault Time: 85-04-03 01:19:43.436383 mst Wed (113442703557347137) 
Setting Temporary pointers from 72 | 240. 

azm: sk stack__4 

Reverse trace of >pdd> zzzzzzzbBBBBBB>stack_4 (Seg 234) 
Number of stack frames 6. 

Stack begin - 234 | 2000 Stack end - 234 | 7340 
FRAME RETURN_PTR 

234 1 5460 404 1 5674 >sss>bound_command_loop_$tty_io_ 1 5674 
234 1 4060 432 1 24345 >t>bound_as_mc_$mc_tty_ 1 3007 
234 13440 251 1 2476 >sll>bound_ipc_$ipc_real__| 2144 
234 1 3260 251 1 327 >sll>bound_ipc_$ipc_fast_| 265 

234 1 2400 256 1 2235 >sll>bound_oc_$ocd_| 2235 

234 1 2000 263 1 410 >sll>bound_system_control_$system_control_ 1 410 

Previoiis stack frame 77777 11 

azm: sk stack_0 

Reverse trace of >sll>stack_0 . 027 (Seg 230) 

Number of stack frames 14. 

Stack begin - 230 | 100 Stack end - 230 | 33620 
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bound_error_wired_l 
bound._355_wired$channel_inanager 1 2156 
bound__library__l__$unwind_stack_ 1 370 
bound_l ibr ary_l_$ ini t_vo l__header__ 1 0 
boiind_library_l_$signal_| 726 
retiirn_to__ring_0_ 1 0 



FRAME EIETURN_PTR 
230 1 30000 3511577 
230 1 12600 122 1 25116 
230 1 12320 41 1 5440 
230)12160 41 1 0 
230 1 11640 41)10366 
230)11220 76)0 
FIM FRAME found at 230)11220 
Machine Conditions at 230)11300: 

Access Violation Fault (51) , Out of Segment Bounds 

PR6 (sp) - 230)7020 >sll>stack_0. 027) 7020 
By: 150)11213 bo\md_x25_ntpx$x25_mpxj 10513 
Ref: 77777)15 >sll>stack__b.027 ) 15 

230 ) 7020 150 ) 0 bound_x25_mpx$x25_mpx_data ) 0 

230 j 6300 122 ) 25335 bound_355_wired$channel_manager j 2375 

230)4660 122)6324 bound_355_wired$dn355 ) 6324 

230 ) 3240 122 ) 22153 bound_355_wired$f np_imiltiplexer j 10207 

230)2520 122)24512 bound_355_wired$channel_manager j 1552 

230)1360 146)34565 bound_tty_active$tty__modes ) 1271 

230 ) 220 146 j 24224 bound_tty_active$ tty_index j 2670 

230)100 317)3374 >sll>hcs_j 3374 

Previous stack frame 234)5460 

azm: sk prds 

Frames may be invalid. 

Stack_begin and stack_end are equal 72)1220, 

Use the -force and -fwd options and proceed at your own risk 

azm: sk prds -fc -fwd 

(fwd) next_sp not valid 27374)0 sp 72)2200 



Forward trace of prds (Seg 72) 
Number of stack frames 4. 
Previous stack frame 230)33620. 
Stack begin - 72)1220 Stack end 



72)1220 



FRAME 

72)1220 

72)1520 

72)1700 

72)2200 



RETURN^PTR 

45)3767 

145)455 

122)5221 

43)24040 



bound_tc_priv$pxss j 3767 
bound_tc_wired$proc_int_handler ) 71 
bound_355__wired$dn355 ] 5221 
bound_page__control$disk_control ) 2474 



azm: mc 230)11220 -Ig 
Machine Conditions from 
Pointer Registers: 

PRO (ap) - 42)17350 



PRl (ab) 

PR2 (bp) 

PR3 (bb) 

PR4 dp) 

PR5 (lb) 

PR6 (sp) 

PR7 (sb) 



77777)1 

150)4155 

230)6174 

150)11253 

77777)1 

230)7020 

77777)1 



Processor Registers: 
XO - 25335 XI - 6556 
X4 - 0 X5 - 3357 X6 ■ 



(230 ) 11300) >sll>stack_0 . 027 ) 11300 . 

bound_library_wired_$pll__operators_ j 1426 
NULL POINTER 

bound_x25__mpx$x25jmpxj 3455 
>sll>stack_0 . 027 ) 6174 
bound_x25_mpx$x25_mpx ) 10553 
NULL POINTER 
>sll>stack__0 , 027 j 7020 
NULL POINTER 

X2 - 777773 X3 - 460 
7 X7 - 1540 
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A Register - 000000000000 Q Register - 000000000040 E Register - 0 
Timer Register - 775006421 Ring Alarm Register - 1 

Access Violation Fault (51) , Out of Segment Bounds 

SCU Data: 

By: 150 1 11213 bound_x25_mpx$x25_mpx| 10513 
Ref: 77777115 >sll>stack__0.027 1 15 
On: cpu c (#2) 
Indicators : '^bar 

AFU Status: sdwamm, sd>on, ptwamm, pt-on, fap 
Instructions : 

20420 7 00014 4501 00 stz pr7jl4 

20421 7 00014 4501 00 stz pr7|14 
Mem Controller Mask: 000230000043 010560000000 

MC Fault Time: 85-04-03 01:19:41.494596 mst Wed (113442703550026504) 
Setting Temporary pointers from 230 | 11300. 

azm: v -a 
ap - 42 1 17350 
ab - 77777 1 1 
bp - 150 1 4155 
bb - 230)6174 
Ip - 150 1 11253 
lb - 7777711 
sp - 230)7020 
sb - 77777)1 
prfr - 23017020 
prmc - 230111300 

azm: d sp -as stack__frame/arg_ptr/ 

stack_f rame . arg_ptr - 230 | 6556 >sll>stack_0. 027 | 6556 



Reverse trace of >sll>stack_0.027 (Seg 230) 
Number of stack frames 8. 

Stack begin - 230)100 Stack end - 230)33620 
FRAME RETURN_PTR 

230 ) 7020 150 ) 0 bound_x25_mpx$x25_mpx_data j 0 

Entry ptr 150)4155 bound_x25_mpx$x25jiipx) 3455 
Operator/Link ptr 42)17350 
Arg ptr 230)6556 

ARG 1: 221)165226 tty_buf) 165226 
ARG 2: 000000000003 
ARG 3: 000000000000 

Previous stack frame 230)6300 

azm: sdw 74 

ADDRESS RNGS GA-MAX REWPUGCDF EBOUND SEGNO SEGMENT-NAME 
6057014 000 1777 R W G DF 0 74 rdisk_seg 

azm: name 41 

41)0 - boimd__library_l_$init_vol_header_)0 
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azm: d 41 | 10360 10 

azm (display): Segment is not in the fdump. 41|10 



azm: d 41 | 10360 10 -inst 

Segno 41 bo\md_library_l_$signal_| 720 



10360 


005146 


3520 


00 


epp2 


10361 


0 00623 


7001 


00 


tsxO 


10362 


000011 


7260 


07 


1x16 


10363 


777103 


3520 


04 


epp2 


10364 


0 00717 


7001 


00 


tsxO 


10365 


000004 


7100 


04 


tra 


10366 


000154 


0000 


00 




10367 


000021 


7100 


04 


tra 



5146 
pro 1 623 
11, dl 

-675, ic 007466 - 000000000000 

prO|717 

4,ic 010371 
154 

21, ic 010410 



azm: absadr 41 | 10360 

bound_library_l_$signal_| 720 (41 1 10360) : 
Absolute Addr 7602360 (Word 7602360 in Mem d) . 



azm: ..cpo fault_vector 

azm: ntunber fault__vector 
fault_vector — Segno 4|0. 

azm: ap 4 "do ""compare fault_vector &1 -In 200"" 
Discrepancies : 

offset contents offset contents 

114 000514657220 114 025720657200 

115 000414710220 115 025773630200 

116 000516657220 116 153450657200 

117 000416710220 117 153450613200 

Total 1 discrepancy, 4 words 

azm: d 4 -as "fault__yector.fpair(6:7)" 
fpair (6) @ 4|114 

scu - "025720657200"b3, tra - "025773630200"b3 
fpair (7) @ 4|116 

scu - "153450657200"b3, tra - "153450613200"b3 



azm: d 4|114 4 -inst 
Segno 4 f ault_vector | 114 

114 025720 6572 00 scu 

115 025773 6302 00 ret 

116 153450 6572 00 scu 

117 153450 6132 00 rcu 



25720 interrupt inhibit 
25773 interrupt inhibit 
153450 interrupt inhibit 
153450 interrupt inhibit 



azm: replace 4 [e wd]>fault_vector 



azm: d 4 -as "fault_vector.fpair(6:7)" 
fpair (6) (3 4|114 

scu => "000514657220"b3, tra - "000414710220"b3 
fpair (7) @ 41116 

scu - "000516657220"b3, tra - "000416710220"b3 
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azm: d 4|114 4 -Inst 
Segno 4 fault_vector | 114 

114 000514 6572 20 

115 000414 7102 20 

116 000516 6572 20 

117 000416 7102 20 



scu 514,* interrupt inhibit 

tra 414,* interrupt inhibit 

scu 516,* interrupt inhibit 

tra 416,* interrupt inhibit 



azm: apte -cur 



APTE #1 at ADDR 3000: 

Processid: 003000777777 (Initializer .SysDaemon.z) ; DBR: 6234350 
State: running at 4/3/85 1:19:41.519133 

azm: d tc__data 1 3000 -as apte 
apte @ 112 1 3000 

thread (§ 112(3000 

fp - "011600«b3, bp - "003600-b3 
flags @ 11213001 

state - « 000001 "b3 

ON: wakeup_waiting , loaded, eligible, pre_empt_pending, 

defaultjprocs_required, dbr_loaded, shared_stack_0 , firstsw 

OFF: stop_pending, pre_empted, hproc, idle, interaction, 

realtime_biirst , always_loaded, being_loaded, page_wait_flag 
page_faults - 10744, processid - "003000777777"b3 , te - 2221386, 
ts - 0, ti - 0, timax - 0 
ipc_pointers @ 112 | 3010 

event_thread - '*034710"b3 
ips_message » " 000000000000 "b 3 
asteps @ 112 1 3012 

pds - "005300«b3, dseg - '•162334"b3 , prds - "000000"b3 
savex7 - '•002402"b3, term_processid - " 000000000000 "b3 , 
lock_id - " 134426563417 "bS, time__vised_ciock =■ 375911791, 
wait_event - " 000000000000 "b3, wct_index - "001110"b3 
flags2 (a 11213021(18) 

special_wakeups - "00''b3, pr_tag - "2"b3 

OFF: prior ity__scheduling , batch 

state_change_time - 2658817181519133 1985-04-03 01:19:41.519133 mst, 
alarm__event - 0, alarm_time_thread - " 010700 •*b3, 

alarm_time - " 113442703634400115 "b3, term__channel - 0, ws_size - 0, 
temax - 2097152, 

deadline = 2658817174541992 1985-04-03 01:19:34.541992 mst, 

lock - ••000212"b3, cpujmonitor - 0, pagingjneasure - 16320822, 

access_authorization - "000000000000000000770000"b3 , 

dbr - 465269129579410522131, virtual_cpu_time - 314797070, 

ittes_sent — 1, ittes_got — 56, current__response_state - 0, 

number_processing - 91, 

last_response_state_time - 

2658817179468364 1985-04-03 01:19:39.468364 mst 
total_j)rocessing__time - 62781250, begin_interaction_vcpu - 312578134, 
saved_temax - 2097152, procs_required - ''FF''b4, ipc_r_offset - 178898, 
ipc__r_f actor - 57812222997, apad (1) through apad (10) - 0 



azm: hregs 

History Registers at (71|220) pds | 220 
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DPS8 History Register Analysis 



HR 




IC or 






c 


Memory 






id 


SeE# 


[ tpr . ca] 


opcode tag y 


Address 


mc 


flazs 


CU 




307 


tnz 






304 


4 


poa raw ic pib port 


OU 
















RS-REG—stac zero carry 


CU 




310 


stac 


n* 


1 


236312 


4 


pia poa riw raw itif its internal 


OU 
















RS -REG— stac zero carry 


CU 


17 






n* 


n 


114776 


4 


poa riw raw its internal 


OU 
















RS- REG— stac zero carry 


AU 




[2776] 








114776 


rO 


fap sdwm (A17) 


CU 


25 








o 


122222 


40 


poa internal 


OU 
















RS -REG— stac zero carry 


AU 




[222] 








122222 


rO 


fap sdwm (A5) 


CU 


230 








o 


122222 


60 


poa raw saw pib port 


OU 
















RS -REG— stac zero carry 


CU 


17 


311 


Ida 


n* 


n 


115000 


4 


poa riw raw ic pib its port 


OU 
















RS -REG— stac zero carry 


AU 




[3000] 








122222 


rO 


fap sdwm (A17) ptwm (Al) 


CU 


25 








o 


122220 


4 


poa raw ic pib port 


OU 
















RS -REG— stac zero carry 


AU 




[2201 








122220 


rO 


fap sdwm (A5) 


CU 


17 


312 


sta 


n* 


i 


236314 


4 


pia poa riw raw inf pib its internal 


OU 
















RS -REG— stac zero carry 


CU 


17 






n* 


n 


115002 


4 


poa riw raw pib its port 


OU 
















RS -REG— Ida sign carry 


AU 




[3002] 








236314 


rO 


fap sdwm (A17) ptwm (Al) 


CU 


25 








o 


122203 


20 


poa raw internal 


OU 
















RS -REG— Ida sign carry 


AU 




[2031 








122203 


rO 


fap sdwn ( A5 ) 


CU 


17 


313 


cioc 


n* 


n 


115004 


4 


poa riw raw ic inh pib its port 


OU 
















RS -REG— sta sign carry 


AU 




[3004] 








122203 


rO 


fap sdwm (A17) 


CU 


25 






ql* 


n 


122104 


4 


poa riw raw ic inh pib port 


OU 
















RS -REG— sta sign carry 


AU 




[1041 








122104 


rO 


fan sdwm ^AS^ 


CU 


25 








o 


122067 


62 


poa raw ic inh internal 


OU 


















AU 




[67] 








122067 


rO 


fap sdwm (A5) 


CU 


44 


314 


dis 




i 


236316 


4 


pia poa raw inf inh port 


OU 
















RS-REG-sta sign carry 


CU 


44 








o 


236314 


4 


poa raw inh internal 


OU 
















RS-REG-sta sign carry 


CU 


44 








? 


236314 


4 


raw inh internal 



OU RS-REG-sta sign carry 



azm: name 17 

17jO - ws_linkage|0 

azm: d 44 | 310 10 -inst 

Segno 44 bound__priv_l$privileged_mode__ut j 310 

310 4 00114 3541 20 stac pr4|114,* 

311 4 00116 2351 20 Ida pr4|116,* 
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312 4 00120 7551 20 

313 4 00122 0153 20 

314 000314 6162 00 

315 000000 2350 07 

316 4 00114 3551 20 

317 4 00112 3551 20 



sta 

cioc 

dis 

Ida 

ansa 

ansa 



pr4|120,* 

pr4|122,* interrupt inhibit 
314 interrupt inhibit 
0,dl 

pr4|114,* 
pr4|112,* 



azm: am -prds 



SDW Assoc 


iative 


Memoiry 


at prds$am_data. 










ADDRESS 


RINGS 


BOUND 


REWPUGC CL F/E USAGE-CT SEG # 


SEG__NAME 


LEVEL [A] 


















6234350 


0,0,0 


17760 


R W 


G 


F 


100000 


0 


dseg 


6357014 


0,0,0 


107760 


RE 


GC 


F 


111000 


42 


bound_library__wired_ 


0 


0,0,0 


560 


R W UG 


F 


111000 


4 


fault_vector 


52056 


0,0,0 


3760 


R W 


G 


F 


111000 


25 


boixnd_hc_data_wired 


52360 


0,0,0 


5760 


R W 


G 


F 


100000 


66 


iom__data 


6240074 


0,0,0 


37760 


R W 


GO 


F 


111000 


230 


>sll>stack__0.027 


6057314 


0,0,0 


7760 


R W 


GC 


F 


100000 


71 


pds 


6241370 


o,o!o 


17760 


REWP 


G 


F 


101100 


72 


prds 


52066 


0,0,0 


21760 


RE P 


GC 


F 


111000 


35 


bound_error__wired_l 


52102 


0,0,0 


5760 


RE P 


GC 


F 


100000 


36 


bound_interceptors 


52046 


0,0,0 


11760 


RElf 


G 


F 


100000 


17 


ws_linkage 


LEVEL [B] 


















52436 


0,0,0 


763760 


R W 


G 


F 


111000 


102 


sst_seg 


52154 


0,0,0 


7760 


RE P 


GC 


F 


111000 


44 


bound_priv_l 


6057334 


0,0,0 


1760 


R W 


G 


F 


111000 


105 


sys_info 


52232 


0,0,0 


3760 


R 


G 


F 


111000 


70 


oc_data 


52366 


0,0,0 


43760 


R W 


G 


F 


101100 


112 


tc_data 


52042 


0,0,0 


1760 


R W 


G 


F 


111000 


15 


lot 


LEVEL [G] 




















n n n 


n -i£.f\ 


T» TT 
fi. W 


f\ 


F 


■« 


12 


unpagedpage tables 


PTW Associative 


Memory 


at prds$am_data 











ADDRESS 


M 


F/E USAGE CT SEG # PAGE 


SEG_NAME| OFFSET 




LEVEL [A] 
















56316000 


yes 


F 


110000 


72 


0 


prds 1 200 




114000 


yes 


F 


111100 


17 


1 


ws_linkage j 600 




136000 


yes 


F 


100000 


35 


3 


bound_error_wired_l 




140000 


yes 


F 


100000 


35 


4 


bound__error_wired__l 




142000 


yes 


F 


100000 


35 


5 


boimd__error_wired_l 




144000 


yes 


F 


100000 


35 


6 


botmd_error_wired_l 




7556000 


no 


F 


111000 


42 


7 


bound__libr ary_wir ed_$ f orml ine_ 


504 


7554000 


no 


F 


100000 


42 


10 


botmd_l ibr ary_wire d_$ f orml ine_ 


1104 


7552000 


no 


F 


100000 


42 


11 


bound_l ibr ary_wired_$ f orml lne_ 


1504 


7550000 


no 


F 


100000 


42 


12 


bo\md__library_wired_$ f orml ine_ 


2104 


7546000 


no 


F 


111000 


42 


13 


bound__library_wired_$formline__ 


2504 


7544000 


no 


F 


111000 


42 


14 


bo\xnd_library_wired_$formline_ 


3104 


42602000 


yes 


F 


100000 


230 


15 


>sll>stack_0 . 027 1 6400 




21244000 


yes 


F 


100000 


230 


16 


>sll>stack 0.027 17000 




47012000 


yes 


F 


100000 


230 


17 


>sll>stack_0 . 027 | 7400 




LEVEL [B] 
















7330000 


yes 


F 


110000 


71 


0 


pds 1 200 




152000 


yes 


F 


111100 


36 


1 


bound_interceptors$f im| 600 




146000 


yes 


F 


111000 


35 


7 


bo\md_error_wired_l 
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6240000 


yes 


F 


111000 


102 


73 sst segl 35600 


3116000 


yes 


F 


111000 


230 


14 >sll>stack_0 . 027 | 6000 


LEVEL [C] 












150000 


yes 


F 


110000 


36 


0 bound__interceptors$fiin| 200 


132000 


yes 


F 


111100 


35 


1 bound_error_wired_l 


LEVEL [D] 












112000 


yes 


F 


110000 


17 


0 ws_linkage 1 200 


312000 


yes 


F 


111100 


70 


1 oc_data|400 



azm: yfam 

No mis -matches or duplicate entries fovmd in SDWAM or FTWAH. 



azm: q 
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07/27/83 analyze_multics , azm 
Syntax: analyzejoniltics { -control_args} 

Function: Invoke a subsystem that will permit the scanning of a Multics 
address space for analysis. 

Control arguments: 
-abbrev, -ab 

enables abbreviation expansion of request lines. 

- no_abbrev , - nab 

does not enable abbreviation expansion of request lines. (Default) 
-no_prompt 

suppresses the prompt for request lines in the request loop. 

- no_s tar t_up , - nsu 

specifies that no startup exec_com is to be executed. (Default) 
-profile PATH, -pf PATH 

specifies the pathname of the profile to use for abbreviation 

expansion. The suffix "profile" is added if necessary. This 

control argument implies -abbrev. 
-prompt STR 

sets the request loop prompt to STR. The default is the ioa__ STR: 
Va2m"[ ("d)"]:''2x 
-request STR, -rq STR 

executes STR as a analyze_imiltics request line before entering the 

request loop. 
-start_up, -su 

specifies that the exec__com ' tart_up . azmec ' is to be executed upon 
invocation of analyze_multics . This start_up exec_com is first 
searched for in the user's home directory, then in the user's 
project directory >udd>Project_id, and last in >site. The first 
exec_com found is used, 
-quit 

Exit analyze_mulitcs after execution of other arguments. Can be 
used in conjunction with -request. 

Notes: analyze_multics uses the standard search list mechanism to 
locate FDUMPs. If analyze_multics does not find a "dumps" search list, 
it will create one, placing >dumps in the search list as the default. 
If additional search paths are desired the "add_search_j)ath" command 
should be used to define them. 



analyze_multics 
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analyz e_mul tics 



09/16/83 



absolute address, absadr 



Syntax: absadr VIRTUAL- ADDR 
[absadr VIRTUAL- ADDR] 



Function: 



Translates a 'virtual address' to an absolute 
memory address. 



Argument : 
VIRTUAL-ADDR 

May be a segment number, name or symbolic address (e.g. 64, prds, 
prds$am__data) . Do a 'help virttaal_address ' for more detailed 
information on acceptable virtual -address constructs. 

Example as active request: 



display__absolute [absadr sst$cmp] 2 



analyz e_mul tics 
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- 2 



absolute address 



07/27/83 add_request_table , arqt 
Syntax: arqt PATH 

Function: Adds a user defined request table in the list of request 
tables being searched by the ciirrent analyze_niultics invocation. 



Argument: 
PATH 

is the path name of the request table to be added. This request 
table must be consistent for use with subsystem utility. See the 
section on subsystem request language in the Programmer's Reference 
Manual for request table structure. 



analyzejomltics 
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add_r eque s t_ tab 1 e 



08/08/83 apply, ap 



Syntax: apply VIRTUAL- ADDR {RANGE} command_line 

Fiinction: Extracts all or part of a segment, specified by VIRTUAL-ADDR 
from the selected FDUMP and places a copy in a temporary segment. The 
new path name is passed as the last argument in the command_line . 



Argument : 
VIRTUAL-ADDR 

Hay be a segment number, name or symbolic address (e.g. 64, prds, 
prds$a]n_data) . Do a 'help virtual_address ' for more detailed 
information on acceptable virtiial- address constructs. 
RANGE 

Specifies the number of words in octal to be copied. The default is 
the entire segment. 
command_l ine 
any command. 

Notes: The offset in the virtual address specifies where the copying of 
the segment begins. Wnen only part of a segment is extracted, it goes 
at the beginning of the temporary segment. For example: 

apply pds$am__data 400 dump_se^ent 

will put 256 (decimal) words at the beginning of the segment. 



analyzejmultics 
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apply 



12/12/83 apte 

Syntax: apte {proc_indlcator} { -control_args} 

Fiinction: displays active page table (apte) information for processes 
in an FDI3MF that match the states specified. 



Argument : 
proc_indicator 

for specifying individual processes. It can take one of three 
forms : 

- The decimal index (starting at zero) of a process inthe FDUMF. 

- The octal apte offset of the process. 

- The octal process__id of the process. 



Control Argiments: 
-all, -a 

Displays apte info for all processes in any state (Default) . 
-blocked, -blk 

Displays apte info for all processes in the blocked state, 
-count, -ct 

specifies the total number of processes meeting the criteria 

specified by the control__args . With -all, it gives the coimts of 

each process state, 
-current, -cur 

displays apte info for the current process. 
-page_tbl_lock, -ptl 

Displays apte info for all processes marked as page table 

locking . 
-ready, -rdy 

Displays apte info for all processes in the ready state, 
-run 

Displays apte info for all processes in the running state, 
-stopped, -stop 

Displays apte info for all processes in the stopped state, 
-wait 

Displays apte info for all processes in the waiting state. 

Examples : 
apte 2 

displays information for process 2 in the FDX3MP. 
apte 10600 

displays information for the process with apte offset 10600 (octal) . 

apte 3500555555 

displays information for the process with octal 
process_id 003500555555. 



analyze_multics 
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apte 



07/20/83 associative_memory , am 
Syntax: am { -control_args} 

Function: Display SDW and/or PTW Associative Memories. 

Control Arguments (Location) : 
-dump 

displays the "dump" Associative Memories from the BOS CPU at the 
time t^e dump was taken. (Default) . 
-prds 

displays Associative memories that have been stored in the current 
processes prds. 

Control arguments: 
-all, -a 

Specifies that ALL entries in the Associative Memories are to be 
displayed. Default is to display only those entries that are valid 
(i.e., the full bit is on), 
-ptw 

Specifies that only the FTW Associative memories are to be displayed, 
-pageno PAGENO 

where PAGENO is an octal page number. Displays only those entries 
in the PTU Associative Memories that have a page number that matches 
the value of PAGENO. 
-sdw 

Specif le35hat only the SDW Associative Memories are to be 
displayed, 
-segno SEGNO 

where SEGNO is an octal segment number. Displays only those entries 
in the SDW and PTW Associative Memories that have a segment number 
that matches the value of SEGNO. See assoc_mem.incl.pll. 

Notes: If no control arguments are given, BOTH the SDW and PTW 
Associative Memories are displayed for the "dump" Associative Memories. 



analyze_multlcs 
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as s oc ia t ive_memo ry 



12/12/83 aste 



Syntax: aste segno/segname { -control_args} 

Fimction: displays active segment table (ast) , page table, and trailer 
information. The default displays active segment table entry (aste) 
and page table information only. 



Argument : 
segno/name 

is the segment niimber or segment name of interest. 



Control Arguments: 
-aste 

Displays active segment table information for the selected entry, 
-brief, -bf 

Displays everything excluding the page table info. This is 
equivalent to specifying -aste and -tr. 
-long, -Ig 

Displays everything which includes the aste, page table and trailer 
information. This is equivalent to specifying -aste, -pt and -tr. 

-page_table , -pt 

Displays page table information for the selected segment. 

-trailer, -tr 

Displays trailer information about the selected segment. 



analyze_multics 
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aste 



08/09/83 configuration_deck, cd 



Syntax: cd {card_names) { control_args ) 

Function: displays the contents of the config_deck in the selected 
FDUMP. This request works exactly like the standard pcd command, the 
only difference is that it gets the config deck from the FDUMP. 



Argument : 
card__names 

are the names of the particular configuration cards to be displayed. 
Up to 32 card names can be specified. If no card__names are given 
the the complete config__deck will be printed. 

Control Arguments: 
-brief, -bf 

suppresses the error message when a requested card name is not 
found. (Default) 

-exclude FIELD_SPECIFIEEIS , -ex FIELD_SPEGIFIERS 

excludes particular cards or card types from being displayed. One 
to 14 field specifiers can be supplied with each -exclude control 
argument, and up to 16 -exclude arguments can be specified. To be 
eligible for exclusion, a card mxist contain fields that match all 
field specifiers supplied with any -exclude argument. 

-long, -Ig 

prints an error message when a requested card name is not found, 
-match F1ELD_SPECIFIERS 

selects particular cards or card types to be displayed. One to 14 
field specifiers can be supplied with each -match control argximent, 
and up to 16 -match arguments can be specified. To be eligible for 
selection, a card must contain fields that match all field 
specifiers supplied with any -match argument. 

Notes: Field specifiers can consist of a complete card field or a 
partial field and an asterisk (*) . An asterisk matches any part of any 
field. Specifiers for numeric fields can be given in octal or decimal, 
but if decimal they must contain a decimal point. Asterisks cannot be 
specified in numeric field specifiers. All numeric field specifiers 
are converted to decimal and matched against ntjmeric card fields , which 
are also converted to decimal. Hence, the field specifier "1024." 
would match a card containing the octal field 2000, and the field 
specifier "1000" would match a card containing the decimal field 512. 

Note that all card names must be specified before the first -match or 
-exclude argument. Field specifiers following a -match or -exclude 
argument include all arguments until the next -match or -exclude 
argument . 
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11/19/84 display, d 



Syntax: d VIRTUAL-ADDR (EXP) {RANGE} {-ctl_args} 

[d VIRTUAL- ADDR {EXP} {RANGE} {-ctl_args}] 

Function: displays a selected portion of a segment in the FDUMF. 



Argument : 
VIRTUAL-ADDR 

specifies the initial offset of the virtual address space to be 
dumped. May be a segment nijmber, name, or s}naibolic address (e.g., 
64, prds, prds$am__data) . Do a 'help virtual_address ' for more 
detailed information on acceptable virtual -address constructs. 

EXP 

is an expression, which is either an octal value or a VIRTUAL-ADDR 
construct yielding an octal value. This value can be positive or 
negative, specified by the plus or minus sign. 
RANGE 

specifies the ntimber of words to be dumped in octal. If a range is 
not specified the default is one word (if the data to be dumped is 
an ITS pair two words will be dumped) . 

Control arguments (Mode Specifications) : 

-character, -ch, -ascii 

displays the selected number of characters in ascii. Characters 
that cannot be printed are represented as periods. As an active 
request, it returns the character representation of the requested 
address . 

- instruction , - Lns t 

displays the selected number of words as instructions. Usage as an 
active request is not allowed. 

-octal, -oc 

displays the selected number of characters in octal (Default) . 
When used as an active request returns the octal value of the 
requested address. 



-ptr, -p 

displays the selected number of word pairs as pointers. When used 
as an active request returns the octal value of the form 
SEGNO I OFFSET, 
-pptr, -pp 

displays the selected number of words as a packed- pointer. When 
used as an active request returns the octal value of the form 
SEGNO I OFFSET, 
-pptrx, -ppx 

displays the selected number of words as packed -pointers and expands 
the segno I offset to a segment name. Usage as an active request is 
not allowed. 



ptrx, -px displays the selected niomber of word pairs as pointers and expands 
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the segno I offset to a segment name. Usage as an active request is 
not allowed. 



Control Arguments: 

-as STRUCTURE_NAME 

displays the data as a hardcore PL/I structure defined by 
STRUCTURE_NAME . The STRUCTURE_NAME is a hardcore system- defined 
include file. The address given in the display request is taken as 
the address of the beginning of the structure. If the whole 
structure is being displayed, that is the address where display 
begins. If only certain elements are being displayed, that is the 
address used to compute offsets of the elements. The structure 
reference following -as must be a single string, containing no 
spaces, and follows the syntax described below. The single string 
is used to specify structure elements, array indexes, and substring 
matching. Usage as an active request is not allowed. 

-long, -Ig 

displays each element of the structure on a separate line. This 
control argument is only implemented with -as. 

Structtire S3mtax: 

The structure reference is made up of two parts: a structure element 
reference, and an optional set of match strings. If no match strings 
are supplied, no string matching is done. The structure element 
reference syntax consists of one or more element names, separated by 
periods, and may contain subscripts following some of these element 
names. The first name in a structure element reference must be a level 
one structure reference; partially qualified top level references are 
not permitted. Intermediate levels of qualification may be omitted as 
long as there is no ambiguity. 

All subscripts must be supplied as decimal integers. The subscripts 
may be cross -section references such as "(1:4)" to reference elements 
one through four. Asterisk bounds may not be used: if a cross -section 
is desired, its upper and lower bounds must be given as decimal 
constants. If an element has more subscripts than are supplied, the 
complete cross -section is printed for the remaining subscripts. Also, 
to eliminate the need for quoting, subscripts may be surroimded by 
braces instead of parentheses. 

In order to specify that only certain elements be displayed (such as 
all those with names containing the string "time"), a set of match 
strings may be given after the structure element reference. Each match 
string begins with a slash and is followed by the string itself. The 
final match string may be followed by a slash, but this is not 
required. If match strings are specified, any element which matches at 
least one string will be displayed. 

Examples of structure references: 
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pvt 

The whole stmcture "pvt". 
pvt , n_entr ies 

The single element "n_entries" in the structure "pvt". 
sst/time/, sst/time 

Any elements in the structure "sst" containing the string "time". 

Note that the final slash is optional, 
sst/ time/meter/ 

Any elements in the structure "sst" containing either the string 

"time" or the string "meter", 
sst. space {3} 

element three of "sst. space". 
sst.space(2:4} 

elements two, three, and four of "sst. space". 



sst. space 

all elements of "sst. space". 

sst.level{l} 

both elements of the "level" array for "sst.level{l} " 
sst . level { 1 } . ausedp , sst . level . ausedp { 1 } 

the single element "ausedp" of the "level" array for "sst.level{l}" 



Structure Output format: 

The default output format is a compressed form, which places as many 
values on a line as will fit within the line length. The -long control 
argument places one value on a line. The short form, additionally, 
collects all bit(l) flags and displays them at the end of the display 
for each substructure or array element, in two groups: one listing all 
the flags which were on ("l"b) , and one for all the ones which were off 
("0"b) . 



All PL/I datatypes are displayed in the same representations used by 
probe. Additionally, the following special formats are ixsed: 

1) Bit strings are displayed as octal, if the length is divisible by 
three, in hex if divisible by four and not three, and as bit 
strings otherwise. 

2) Character strings are displayed as a string concatenated with a 
repeated constant, if the string is padded on the right with more 
than sixteen nulls, spaces, or octal 777 characters. 

3) Large precision (> 51) fixed binary values are also displayed as 
clock readings, if their values represent clock readings within 
ten years of the present. 



Display Examples: 
d 75|560 2 

displays the two words in seg number 75 starting at offset 560. 

d pdsj560 2 displays the two words in the segment named pds starting at 
offset 560. 
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d pds$trace 

displays one word In the pds segment beginning at the offset 
specified by $trace. 



display 244 1 260 +20 4 

displays four words of segment number 244 starting at offset 300 
octal . 

d sp 20 

displays 20 octal words starting with the segment offset defined In 
the azm Internal temporary pointer (see set request) . 



d sst$cmp,* +sst$cmesize sst$strslze 

causes the word at sst$cmp to be used as an Indirect word, or an 
Indirect pointer If the resultant address has ITS modification, to 
develop the starting virtual address. The value derived from 
sst$cmeslze will then be added to the starting offset for the 
'final' starting address. The range, or number of words to be 
displayed, is specified by the value contained in sst$strsize. 

d sst|2 -as apte 

displays the APTE entry at the given offset in the SST as it is 
defined by apte. incl.pll. 
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07/26/83 display_absolute , da 

Syntax: da ABS-ADDR {range} {-ctl_args} 

[da ABS-ADDR {range} {-ctl_args}] 

Function: dumps an absolute memory address space in the FDUMF. 



Argument : 
ABS-ADDR 

is the starting absolute memory address, in octal. 
RANGE 

specifies the number of words to be dtamped in octal. If a range is 
not specified the default is one word (if the data to be dumped is 
an ITS pair two words will be dumped) . 



Control arguments (Modes) : 
-character, -ch, -ascii 
-instiruction, -inst 
-octal, -oc 
-ptr, -p 
-pptr, -pp 
-pptrx, -ppx 
-ptrx, -px 



Notes: For a description of the mode specifications, see the display request. 
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01/23/85 events, ev 



Syntax ; events { - contr o l__ar gs ) 

Fimction: Displays 'interesting events', in reverse chronological 
order, from an FDXJMP. Those events considered to be interesting are 
described in 'notes'. 



Control Arguments: 
-last (N), -It {N} 

specifies the number of events to print. If no N, the default is 

10 events, 
-long, -Ig 

specifies that disk queue events are to be displayed, 
-time (NSECS), -tm (NSECS) 

specifies the time in seconds before the dump was taken when events 
were 'interesting'. Default is 10 seconds. 



Notes: The following events are considered as interesting: Machine 
Conditions (from BOS, prds, pds and the mc_trace_buf ) , Traffic Control 
state change time, Syserr messages (from both syserr__data and 
syserr_log) , Fim frames in any stack, connects by device and disk 
queues (long report ONLY) . 

If neither -time nor -last are specified, the default action is 
equivalent to "ev -time 10". 
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08/05/83 history_regs , hregs 

Syntax: hregs {HREGS__specifier} { -control_args} 

Function: Displays a composite analysis or octal dump of the processor 
history registers. This request, hregs, is useful by people who are 
knowledgable of the hardware. The default action is to display the AU, 
GU and OU history registers for the pds in a threaded order and 
interpreted format. 

Argument (HREGS Specifiers): 

-condition VIRTUAL- ADDR, -cond VIRTUAL- ADDR 

displays history registers from a condition frame, the location of 

which is described by VIRTUAL- ADDR. 
-dump 

displays the "dump" history registers from the BOS CPU at the time 
the dump was taken, 
-pds 

displays the history registers that have been stored in the current 
processes pds (Default) . 
VIRTUAL-ADDR 

displays the history registers that have been stored at the address 
space specified by VIRTUAL-ADDR. See virtual_address . inf o . 

Control Arguments: 
-au 

specifies that only the APU history registers are to be displayed, 
specifies that only the CU history registers are to be displayed. 

-du 

specifies that only the DU history registers are to be displayed. 
- interpret 

Display the interpreted form of the history registers only 
(Default), or, if -octal is specified, include the octal 
representation also, 
-octal, -oc 

Displays the octal values of history registers only, or, if 
-interpret is also specified, display octal and interpreted form. 
If neither -octal nor -interpret is specified, the default action is 
to display the interpreted form only. 
- thread 

Attempt to display the selected history registers in the "correct" 
order (Default) . 
-no_thread 

Display the selected history registers in serial order, without 
attempting to sort them, 
-ou 

specifies that only the OU history registers are to be displayed. 
Notes: Use of the -au, -ou, -cu and -du control arguments imply -no_thread and the 
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10/03/84 list_dumps, Isd 
Sjmtax: Isd {PATH) {-ctl_args} 

Function: Lists dumps in the selected dump directory. If PATH 
is not given, all dumps in the dtimp directories specified in the 
dumps search list are listed. 



Arguments : 
PATH 

specifies PATH as the dump directory to list. Stamames are 
acceptable . 



Control Arguments: 
-deadproc, -dp 

specifies list only dead process directories. If PATH is not 
given, it checks all directories in the dumps search list for 
dead processes, 
-fdump, -fd 

specifies list only f dumps. If PATH is not given, it checks 
all directories in the dumps search list. 

Notes: If no arguments are given, the default is to list only 
f dumps . 
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01/19/84 list_processes , Isp 

Syntax: Isp {proc_indicator} { -control_argument) 

[ Isp { proc_indicator } { - control_argunient } ] 

Function: Lists all known processes in the selected FDXJMP. 



Function as Active Request: 

Returns the process__ids meeting the control argument criteria, 
rettiming a null string otherwise. If -count is specified, only the 
total is returned. 

Argument : 
proc__indicator 

for specifying individual processes. It can take one of three 
forms: 

- The decimal index (starting at zero) of a process inthe YDXMP. 
' The octal apte offset of the process. 

- The octal process_id of the process. 



Control Arguments: 
-all, -a 

Lists all processes in the FDUMP (Default) . 
-blocked, -blk 

Lists processes marked as blocked, 
-count, -ct 

specified by the control__args . With -all, it gives the 
counts of each process state including the overall total. 
- curxerit , - cur 

Lists the current process. 
-page_tbl_lock, -ptl 

Lists processes marked as page table locking, 
-ready, -rdy 

Lists processes marked as ready, 
-run 

Lists processes marked as rtxnning. 
-stopped, -stop 

Lists processes marked as stopped, 
-wait 

Lists processes marked as waiting. 

Example: do "select_process &l;sdw 0" ( [list_processes] ) 
Would display the SDW for DSEG for all processes in the FDUMP, 



analy2e__mul t ics 



F88, 7 - 17 



Iist_processes 



01/19/84 machine__conditions , mc 

Syntax: mc lMC_specifier) {-control__args) 

Function: Displays all or parts of Machine Conditions based on the 
given pointer. 



Argument (MC Specifiers) : 
-dump 

specifies the dtunp for the BOS CPU regs at time of dtanp. 
-pds' (STRl) 

where STRl can be: 
all 

flm, flm__data 

pgf, page_fault, page__fault_data 
slg, signal, signaller, slgnal_data 
and defaults to 'all' If STRl Is not given, 
-prds {STB2} 

where STR2 can be: 
all 

flm, flm_data 

Int , Interrupt , lnterrupt_data 
sys , system_trouble , sys_trouble_data 
and defaults to 'all' If not given. 

VIRTUAL-ADDR 

Is the virtual address construct used to define the address space 
containing Machine Conditions (see vlrtual_address . inf o) . 
The virtual address can point to the machine condltons directly or 
It can point to the frame within which the machine conditions reside. 
In the latter case, the offset Is calulated for the user. 

Control arguments: 
-els 

display the EIS Pointers & Lengths (Interpreted) . 
-faults, -fit 

display the fault register, 
-long, -ig 

display all elements of the MC. 
-mc__err 

display the mc__err data word, 
-mlsc 

display the miscellaneous data (le: mc_err, fault reg, time) 
-octal, -oc 

display the els Info, scu data, or pointer registers In octal. 

-octal Is used In conjunction with -scu, -els or -regs. 
-pointers {PR_LIST} , -prs {PR_LIST} 

displays pointer registers selected by PR_LIST (from 0 to 7, 

separated by spaces) . If PR_LIST Is not specified, all the pointers 

are displayed, 
-ppr 

only display the PSR and IC from the MC. 
-registers {REG__LIST) , -regs {REG_LIST) 
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displays only the basic OU registers. Where REGS__LIST can be any of 
the following: 

xO xl x2 x3 x4 x5 x6 x7 a q all. 

If RE6_LIST is not specified, all of the basic OU registers are 
displayed. 

-scu 

display only the scu data of the MC. 
- time , - tm 

display the MC time, 
-tpr 

only display the TSR and the OA from the MC. 



Notes: If no MC Specifiers are specified, the temporary pointer prmc is 
used. The default control arguments are: 

-fault, -mc_err, -pointers -scu, -time and -tpr. 
The machine_conditions request will set all azm- defined temporary 
pointers as seen in the machine__condition frame. 
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08/09/83 page_trace, pgt 

Syntax: pgt {-control_arg} 

Function: displays the contents of the page trace table in the current 
process data segment (PDS) . The default is to display the last 15 
trace entries. Trace entries are always displayed in reverse 
chronological order. 



Control Arguments: 
-all, -a 

specifies that all trace entries are to be displayed, 
-last N, -It N 

specifies the number of trace entries, where N is a positive decimal 
integer, to be displayed. 
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07/26/83 replace, rp 



Syntax: replace segno/segname PATH 

Fimction: Replaces the segment designated by segno/segname in the 
current translation table, with another segment designated by PATH. 



Argument : 
PATH 

is the path name of the segment. The equal convention can be 
used: replace bound_system__faults [e wd]>— .new 

segno/segname 

the segment number or segment name within the translation table to 
be replaced. 



Notes: Both per-process and per- system segments can be replaced. For 
example, if the pds is replaced in a process, it affects only the 
current process, whereas if tc__data is replaced in a process, it 
affects the whole FDUMP. 
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sciis 
Syntax: sens 

Function: Prints the memory address space (in octal) of each scu from 
the registers saved in the FDUMP. 



analyze_multics 



F88, 7 - 22 



scus 



01/21/85 sdw 



Syntax: sdw {segno/name} {segno/name} 

Function: Displays the SDW's in the current processes DSEG. 



Argument: 
segno/name 

is the segment number or name of interest. The first is the 
starting segment number and the second is the ending segment 
number. If only one is given then only one is displayed if none 
are given then all are displayed. 



SDW Display: 

The sdw request displays the segment number, name, memory address, 
ring brackets, the maximxsn computed address, the entry bound address 
and a bit string REWPUGCDF. 



Display definitions: 
ADDRESS 

is the base address of the segpient or segment page table. 
RNGS 

the ring brackets of the segjnuent. 
CA-MAX 

the highest computed address that may be used in referencing the 
segment without causing an out__of__segment_bounds fault. 

T?T»rkTTkTPk 

is the entry bound or call limiter. Any external call to this 

segment must be to an offset less than the EBOUND if the entry 

bound switch (G) is off. 
SEGNO 

segment number. 
SEGMENT-NAME 

segment name. 



Display definition of REWPUGCDF: 
REWPUGCDF 

The letter will show in the sdw display of the segment if the bit 
is on. The REWPUGCDF string is broken down as follows: 

R is the read permission bit 

E is the execute permission bit 

W is the write permission bit 

P is the privileged bit 

U is the unpaged bit, segment is unpaged is this is on 

G is the gate indicator or entry bound bit. If off, the entry 

bound is checked by hardware 
C is the cache enable switch. 

DF is the directed fault bit. If on, the necessary page of the 
segment is in memory. 
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Example of SDW display: 

ADDRESS RNGS GA-MAX REWPUGCDF EBOUND SEGNO SEGMENT-NAME 
6262154 000 177777 R W G DF 0 200 str_seg 

0 000 37777 R W G 0 300 >udd>Multics>GDixon 
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07/26/83 search, srh 



Syntax: search VIRTUAL- ADDR {range} SEARCH_STRING 
[search VIRTUAL- ADDR {range) SEARCH_STRING] 



Function: This conmand will search a segment starting at VIRTUAL- ADDR 
matching on SEARCH__STRING . The search is performed on a 36 bit word 
boundary. As an active reqxzest, the virtual addresses matching the 
criteria specified is returned. 



Argument : 
VIRTUAL-ADDR 

is the pointer to the address space to search. See 
virtual_address . info 
range 

specifies the number of words to be searched from the starting 
offset, where range is an octal value. The default is the rest of 
segment. The search is started from VIRTUAL-ADDR. 

SEARCH_STRING 

This is a 12 character string representing the 12 octal digits that 
make up a machine word (36 bit, 3 bits per digit). This will be used 
to form both the search data and search mask, by using the hyphen 
(-) as a "don't care character" in the string. The "do care digits" 
are octal "0 -> 7". Any other character is illegal. 

Examples: To search for: 

1) all words in segment 76 that have the last two digits of 43: 

search 76 43 

2) all words in tc_data where the upper half - 070707 

search tc__data 070707 

3) words that end in 1234 in sst_seg starting at 1000 but only 
searching for 200 octal words 

search sst_seg|1000 200 1234 



4) words that start with 45 and end with 77 starting a sst_seg$ptl 
for 100 words 

search sst_seg$ptl 100 45 77 
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12/12/83 segment_naine , name 

Syntax: name [ VIRTUAL- ADDR | niimber] 

[name number] or [name VIRTUAL-AODR] 

Function: Prints the segment name given a virtiial address or a segment 
number . 



Argument : 
VIRTUAL-ADDR 

is the virtual address construct used to define the segment (see 
virtixal_address . info) . 

number 

is the segment nvimber of the segment to be referenced. Thus, "name 
230** returns the name associated with the segment number 230, which 
is "stack 0". 
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12/12/83 segment__n\amber , number 



Syntax: number [ VIRTUAL- ADDR | name] 

[number name] or [number VIRTUAL- ADDR] 

Ftmction: Prints the segment niomber given either a virtual address or a 
segment name. 

Argument : 
VIRTUAL-ADDR 

is the virtual address construct used to define the sepient (see 
virtual__address . info) . 

name 

is the name of a segment, e.g., stack__0. Thus, "number sst^seg" 
returns the segment number associated with the segment sst_seg, 
which is "77". 
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10/03/84 select_deadproc , sldp 
Syntax: sldp {NAME} 

Function: Selects and translates a dead process. Found via the 
dumps search list. The default path in which deadprocs are found is 
>duinps>save_pdirs . 

Arguments : 
NAME 

Is the name of the process directory of interest. This can be a 
relative or absolute pathname. The dead process directory name is 
of the form person. pdir or person. N.pdir, where N is a nijaneric 
number, N-1 for the most recently copied dead process. The suffix 
"pdir" is assumed if not given. 



Notes: When sldp is invoked with no arguments, it prints an identifying 
message. This is identical to how the select_dump request works. 
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10/24/84 select__dump , sld 

Syntax: sld {NAME) { -control_args} 

Function: Selects and translates an FDUMP of a system crash. Foiind 
via the dump search list which defaults to >dumps. 



Argument : 
NAME 

is the ERF number or the path name of the zero (0) component of 
the FDUMP. It can also be the form path>35 where 35 is the erf 
number. Several control_args are also acceptable if NAME is not 
specified. 



Control arguments: 
-first, -ft 

selects the first dump (by erf ntsnber) in the dump directory found 
via the dump search list. 

-last, -It 

selects the last (most current) dump in the dump directory 
according to erf number, 
-next, -nx 

selects the next dump in the dump directory. This is relative to 
the dump currently being looked at. 
-previous , -prev 

selects the previous dump in the dump directory. This is relative 
to the dump currently being looked at. 

NOTE: 

The sld command will attempt to select the process as 
indicated by scs$trouble_processid. If this cannot be done 
the the default will be the first nmning process found in 
the dtimp. 
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07/20/83 select_process , sip 

Syntax: sip {proc__indlcator} { -control_argumeiit} 
Function: selects a process for examination. 



Argument : 
proc__indicator 

for specifying individual processes. It can take one of three 
forms : 

- The decimal index (starting at zero) of a process inthe FDUMP. 

- The octal apte offset of the process. 

- The octal process_id of the process. 



Control arguments: 
-brief, -bf 

suppresses the message about changing processes, 
-cpu TAG 

selects the DBR for the process running on the C?U identified 

by TAG (where TAG is one character a -> h) . 
-dbr dbr_value 

selects the process defined by the dbr__value. 
-long, -Ig 

prints a message annoimcing the new process selected (Default) . 



analyzejmultics 



F88, 7 - 30 



select_process 



set 

Syntax: set PTR__N VIRTUAL- ADDR 

Function: set a internal temporary pointer much like a cpu pointer 
register (i.e. "pre" or "sp"). These pointers can then be used as a 
VIRTUAL-ADDR by other analyze__multics commands. 



Argument: 
VIRTUAL-ADDR 

may be a segment ntimber, name or symbolic address (e.g. 64, prds, 
prds$am__data) . Do a 'help virtual_address ' for more detailed 
information on acceptable virtual -address constructs. 
PTR_N 

can be either the name or number of a ' temporary pointer ' . There 
are 8 temporary pointers and 2 special case pointers. 



luomber name number name 

prO ap pr4 Ip 

prl ab pr5 lb 

pr2 bp pr6 sp 

pr3 bb pr7 sb 



prmc intended to be a pointer to the current MCs. 

prfr intended to be a pointer to the current stack frame. 

Examples : 

set pr6 240 1 100 this would set a temporary ptr named pr6 (sp) . 
set sb 240 this would set the temporary ptr (sb) to the 

base of seg 240 (240 jO). 

Notes : 

The value of a temporary pointer can be displayed via the value 
request: value {ptm | -all} 
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08/10/83 stack, sk 



Sjmtax: sk VIRTUAL- ADDR { -control_arguments} 
Function: Traces a given stack. 



Argument : 
VIRTUAL-ADDR 

is any segment and offset value that is acceptable to the dump 
command. See virtual address. info 



Control arguments: 
- arguments , - ag 

prints the arguments for the stack frames traced, 
-for N 

will trace for N stack frames. If no valid stack 
frames exist (stack_begin_ptr - stack__end_ptr) , a -fc must be used, 
-force, -fc 

will force a forward stack trace. To be used when there are no 
valid frames for this stack (stack_begin_ptr - stack_end__ptr) . 

- forward , - f wd 

will trace in a forward manner. 

-long, -Ig 

will cause the arguments and an octal dump of the 
stack frames traced. 



Notes: The default is to trace the stack in reverse order unless -fc or 
-fwd are specified. If the VIRTUAL-ADDR has a zero offset then the 
trace starts at the offset of the first stack 

(stackjieader.stack__begin_ptr) . If the VIRTUAL-ADDR has a non-zero 
offset then the trace is started from that offset in the given stack. 
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stack 



01/21/85 structxire__names 



This info file lists the structure names to be used for the -as 
control argument of the display request. Not all structure names are 
the same as what's used for the -as request. This is due to naming 
conflicts between different structures, structures containing refer 
extents, and unmeaningful names. 



Structure names (aim template - 


bos_diimp) : 


INCLUDE FILE NAME 




STRUCTURE 


NAME USED IN DISPLAY 


aim_template 




aim__template 


aim__template 


answer_table 




us e r_tab le__ent ry 




anstbl 


answer_table 


apte 




apte 


apte 


area_s true tur es 




areajheader 


area__header 


extend_block 


extend_b lock 


block 


areajblock 


ast_lock_meters 




as t_lock_me ter s 


ast_lock_meters 


aste 




aste 


aste 


bos_dump 




dump 


bos_dump 


Structure names (cdt - dir. 168) 


: 


INCLUDE FILE NAME 




STRUCTURE 


NAME USED IN DISPLAY 


cdt 




cdt 


cdt 


condition__info 




condition__info 


condition__info 


conf ig__deck 




config__deck 


config_deck 


confi^card 


config__card 


cmp 




cme 


cme 


cma 


cma 


mcme 


mcme 


dbm 




dbm 


dbm 


dbr . adp 




dbr . adp 


adp_dbr 


dbr. 168 




dbr. 168 


168 dbr 



Structure_names (definition - dir_l ink) : INCLUDE FILE NAME 
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structure names 



STRUCTURE 
definition 

definition 
dir_allocation_area 

area 
dir_acl 

acl__entry 

access^name 
dir__entry 

entry 
dir_header 

dir 
dirjit 

hash_table 
dir^link 

link 



Structure_names(dir_name - 
INCLUDE FILE NAME 

STRUCTURE 
dir_name 

names 
dir__lock_seg 

dir_lock_seg 

dir_lock_seg_header 

dir__lock 

lock 
disk_table 

dt 

dte 

Ive 
dn355__data 

datanet_info 

fnp__info 



NAME USED IN DISPLAY 

definition 

dir_allocation_area 

dir__acl__entry 
dir__access_name 

dir__entry 

dir_header 

dirjtiash_table 

dir_link 

data) : 

NAME USED IN DISPLAY 

dir__nanie 

dir__lock_seg 
dir_lock__seg_header 
dir_lock 
fast_lock 

disk_table 

disk_table_entry 

disk_table_lv__entry 

datanet__info 
fnp__info 



S true tur e_name s ( dn3 5 5 
INCLUDE FILE NAME 

STRUCTURE 
dn3 5 5_iiiai Ibox 

datanet_mbx 

sub__mbx 

short__fnp__s\ib__inbx 
fnp_sub_mbx 
input__subjDnbx 
dskdcl 

disk_data 
disktab 

disk__channel_table 
chantab 

devtab 
quentry 

S tructure__names ( ect_s 



- dskdcl): 

NAME USED IN DISPLAY 

datanet_mbx 

short_fnp_subjmbx 

short_fnp_sub__mbx 

fnp_sub_mbx 

input_s\ib_mbx 

disk_data 

disktab 

disk__channel_table 
chantab 

devtab 
quentry 

- f lagbox) : 
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INCLUDE FILE NAME 

STRUCTURE 
ect_structures 

ect__header 

wait_chaimel 

call_channel 

event_message 

itt_message 

event__channel__name 

fa3t_chaimel_name 

event_message_data 
event__call_info 

event__call_info 
event_wait_info 

event_wait_info 
faiilt_vector 

fv 
flagbox 

fgbx 



NAME USED IN DISPLAY 

ect_header 
wait_channel 
call_channel 
eventjnessage 
ittjmessage 
event__channe l__iiame 
fast_channel_iiame 
event jnes sage__data 

event_call__info 

event_wait_info 

fatilt_vector 

fgbx 



S tructure__nanies ( f s_vol_label 
INCLUDE FILE NAME 

STRUCTURE 
fs_vol_label 
label 

int_unpagedjpage_tables 

iupt 

iupte 
io_page_tables 

io_page_t:ables 

1.G ^trw 

lo_ptw 

io_pt:w 
io__spec ial_s tatus 

lo_special__s tatus 
io_status 

status 
io_s tatus_entry 

io_s tatus_entry 

io status word 



io__status__entry) : 

NAME USED IN DISPLAY 

disk_label 

iupt 
iupte 

io_page_tables 

io__ptw 

io_j)age__tab le_2 5 6 
io__page__table__64 

io__special_status 

io__s tatus 

io__status_entry 
io status word 



S tructure__names ( io_syserr_msg 
INCLUDE FILE NAME 

STRUCTURE 
io_syserr__ms g 

io_msg 
iocbx 

iocb 
ioi_data 

ioi_data 

gte 

dte 
lorn data 



iom__data) : 
NAME USED IN DISPLAY 
iojQisg 
iocb 

ioi__data 
gte cte 
dte 



cte 
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structure names 



ioin__data 

per_device 

per_iom 

iom__mailbox_seg 
lom_mailbox 
channel mailbox 



iom_data 

iom_per_device 

iom_per_iom 

iomjD[iailbox_seg 

loinjnallbox 

channel mailbox 



Structure_names(iom__dcw - its) 
INCLUDE FILE NAME 

STRUCTURE 
iom_dcw 

dew 

tdcw 
iom_lpw 

Ipw 

lpw__ext 
iom_pcw 

pew 

idcw 
iom_scw 

sew 

its 

its 

i t s_uns 1 gned 
itp 

i tp__uns i gned 



NAME USED IN DISPLAY 

iom_ddcw 
iom__tdew 

iom__lpw 
iom_lpw_ext 

iomjpew 
iom__idcw 

iom_scw 

its 

its_unsigned 
itp 

itp_unsigned 



S true tur e_name s ( i tt_entry - 
INCLUDE FILE NAME 

STRUCTURE 
itt_entry 
itt_entry 

kst 

kst 
kste 

let 

let 
Icte 
linkdcl 
link 

exp__word 

type_pair 
header 

virginal inkage Jheader 
trap_word 



linkdel) : 

NAME USED IN DISPLAY 

itt_entry 

kst 
kste 

let 
Icte 

link_pair; 

1 ink_exp_word 

1 ink_type_pair 

1 inkage__header 

vir gin_l inkage_header 

1 ihk__tr ap_wor d 



S true ture_names (lot - mcs_modes_change__list) : 
INCLUDE FILE NAME 

STRUCTURE NAME USED IN DISFLAYlot 

lot lot 

isot isot 

isotl isotl 
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structure names 



Ivt 

Ivt 
Ivte 

mc 

mc 

scu 

scux 
inc_trace_buf 

mc_tracejbiif 
mcs__modes_change__list 

mcl 

mcle 



S tructure_names (nic__trace__data 
INCLUDE FILE NAME 

STRUCTURE 
nics__trace_data 

trace__array 

trace_entry 
mdcs 

mdcs 

mdlrexit 

acctent 

mdcs__pat:h 
mstr 

mst_label 

mstr_lieader 

instr__trailer 

volume_identifier 

mst_volume_id 
oc_data 

oc data 



Structure_na]nes (oc__log__meters 
INCLUDE FILE NAME 

STRUCTURE 
oc_log_meters 

olm 
pathname__am 

pam 

pcb 

pcd 
pitmsg 

pit 
ptw.adp 

adp__core_p tw 

adp_ptw 
ptw.168 

168_core_j>tw 
pv_holdt 

pyjioldt 



Ivt 
Ivte 

mc 

scu 

scxix 

mc__trace__buf 

mode s_change_l i s t 
modes_change_l is t_entry 

oc_data) : 

NAME USED IN DISPLAY 

mcs__trace__array 
mcs__trace__entry 

mdcs 

mdcsjndir 

mdcs__account 

mdcs_path 

mst_label 
mstr_header 
mstr_trailer 
ms t_voltjme_id 
mst_voliame_id 

oc data 



pv_holdt) : 
NAME USED IN DISPLAY 
oc__logjaieters 
pathiiame_am 
pcd 
pit 

adp_core__ptw 
adpjptw 

168_core_j)tw 168_ptw 168_ptw 
pv_holdt 



analyze_jmiltics 



F88, 7 - 37 



structure names 



Structure_names (pvt 
INCLUDE FILE NAME 
STRUCTURE 

pvt 

pvt 
pvte 
pvte 

pvt_array 
rcp_com_seg 

res 

rose 
rcp_data 

rcpd 

dtype 

device 

volume 
mt 

mt 
mte 



rnt) 



NAME USED IN DISPLAY 
pvt 

pvte 

pvt_array 

res 
rese 

rcpd 

rep__dtype 

rcp_device 
rcp_volume 

mt 
mte 



Strueture_names(sdw.adp - sit) 
INCLUDE FILE NAME 

STRUCTURE 
sdw.adp 

adp_sdw 
sdw.168 

168_sdw 
sdw_info 

sdw_info 
s e gdainage_ins g 

s e gdamage_ins g 
signaller_stack 

s lgnaller_s tack 

sit 

sit 

name_seg 
segnam 
path 
aels 



NAME USED IN DISPLAY 

adp_sdw 

168__sdw 

sdw_info 

segdamagejms g 

signaller_stack 

sit 

slt_jiame_seg 
slt_segname 
slt_path 
sit aels 



Strueture__names (site 
INCLUDE FILE NAME 
STRUCTURE 

site 
site 

sst 

sst 

sstnt 

sdt 

sdte 
staek__frame 

staek__fraine 
stack header 



str) 



NAME USED IN DISPLAY 

site 

sst 

sstntstaek__0_data 

stack_0__data 

sdte 

stack frame 
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38 



structure names 



stackjieader 

str 

str 



stackjieader 
segment__trailer 



S tructiare_iiaiiies ( syserr_data 
INCLUDE FILE NAME 

STRUCTURE 
syserr_data 
sd 

wlog 
wmess 
syserr_log 
slog 
smess 

tcb 

tcb 

tcm 

tcm 
tcm 

wct_entry 



Stnicture_iiaiiies (tt^_btif 
INCLUDE FILE NAME 

STRUCTURE 
tty_buf 

ttyjDuf 
tt:y_buffer_block 

buffer 

free_block 

■»-+-.» *-^'U.^ 

tt:y_tables_Jidr 
unpaged_j)age__tables 
upt 

upt_entry 
vol_map 

vol_map 
voliime__registration 

volume__regis trat ion 



wct_entry) : 

NAME USED IN DISPLAY 

syserr__data 
wired_syserr__log 
wired__syserr__message 

syserr__log 
syserr_message 

tcb 

tc_data 
tcm 

wct_entry 

voliime_registration) : 

NAME USED IN DISPLAY 

tty_buf 

tty_buffer 
free_ttr7_buffer 

tty_tablesjbdr 

upt 

upt_entry 
vol_map 

voliime_registration 



Structure__names (vtoc__buf f er - wtcb) : 
INCLUDE FILE NAME 

STRUCTURE 
vtoc__buffer 

vtoc_buffer 
vtoc_header 

vtoc__header 

vtoce 
wire_proc_data 

wpd 
wtcb 

wtcb 



NAME USED IN DISPLAY 

vtoc_buffer 

vtoc__headervtoce 
vtoce 

wire_j)roc_data 
wtcb 
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01/21/85 syserr_log, slog 
Syntax: syserr^log { -control__args) 

Function: Displays all or parts of the syserr_log and syserr_data 
segments from the dump. It does not examine the perm__syserr_log . The 
default is to print the entire log and all actions. 



Control arguments: 
-action A 

displays messages starting at severity -100 and up to the action 
code specified by A, where A is a decimal integer between -100 and 
100. A range can also be specified, consisting of a pair decimal 
integers separated by a colon ("20:29"). 
-exclude STR -ex STR 

where STR is a string that is matched against the log, as for 
-match. Any message that contains STR is not printed. 

-last N, -It N 

where N is a decimal integer. This argument specifies that the scan 
is to start N messages back from the end of the log. 
-match STR 

where STR is a string to be matched against messages in the log. 
Any message that contains STR is a candidate to be printed, 
-expand, -exp 

specifies that messages that have binary data will have that binary 
data interpreted. The format is generally dependent on the text of 
the message. 
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08/23/83 traf f ic__control_queue , tcq 
Syntax: tcq { -control__args} 



Function: Displays process DBR, process state, process ID, current CPU 
and USERID from the Traffic Controllers Eligible Queue, as well as the 
"process number" in the FDUMP. The default is to display only the 
eligible queue. 



Control Arguments: 
-all 

Displays the eligible, realtime, Interactive and workclass queue 
entries. Including the unthreaded entries. 

-ready, -rdy 

Displays the eligible, realtime, Interactive and workclass queues, 
excluding the tinthreaded entries. 
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07/27/83 value, v 

Syntax: v PTR_Ni. .PTR_Nn | -all 

Function: Displays the current value of one or all of the temporary 
pointers . 



Argument : 
PTR__N 

specifies which of the temporary pointers is to be displayed. Refer 
to the set request for a list of the azm defined pointer names. 
User -defined pointers can also be specified, 
-all, -a 

specifies that all of the pointers are to be displayed (Default) . 
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verify__associative_memory, vfam 

Syntax: vfam { -control_args) 

[vfam { -control__args) ] 

Function: Performs a consistency check on the Associative Memories 
stored at the time of a dump by comparing them to the appropriate 
entries in the "dump dseg" and page tables. When used as an active 
request returns "triae" if any inconsistencies are found, "false" 
otherwise . 



Control Arguments: 
-ptw 

restricts the verification to the PTW Associative Memories, 
-sdw 

restricts the verification to the SDW Associative Memories. 



Notes: If no argument is given BOTH SDW and PTW Associative Memories 
are checked. 
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12/12/82 Virtual Address Constructs 

Accessing data requires some pointer value to define an address space. 
The generation of the pointer value is performed by resolving a virtual 
address (VIRTUAL-ADDR) . A VIRTUAL-ADDR consist of two parts, a segment 
number and a word offset. 

Analyze_multics (azm) will resolve VIRTUAL-ADDR' S from the following 
types of information: 



Symbols : 

is a symbolic name for a segment nixmber and an offset (i.e., sst$ptl 
can be resolved to the correct segment number and offset of the page 
table lock) . 



Segment name: 

a segment name can be resolved in many ways, but it can only provide 
one part of the virtual address; azm uses 0 as the default offset 
for this pointer value (i.e., tc__data is resolved to SEGNO |0). 



Segment number: 

a segment number needs no resolution, but a default action needs to 
be taken for the offset (the default is 0, i.e., SEGNO |0). 



Segpient name/number and offset: 

The VIRTUAL-ADDR in this case can be a segment name or segment 
number and an octal offset (i.e., the construct of pds|20 is 
translated to SEGNO | 20 or dseg|5 is 0|5). The notation " | " and 
must be used without spaces (e.g., 244|0 or sst$cmp) . 



Temporary pointers: 

azm keeps a set of 11 temporary pointers per translation. A 
translation is one complete entity such as an "FDUMP". These 
pointers can be set with the set request (e.g., set sp 230 | 100). 
They can be referenced by other requests as another type of "symbol" 
in a VIRTUAL-ADDR expression, after they have been set. If not set, 
these pointers are null. 



Offset Operators: 

The operators "+N" and "-N" immediately preceding an octal number, 
or VIRTUAL-ADDR construct can be used to alter the offset of a 
virtual address. N is a number interpreted in octal. No spaces are 
allowed between the operator and the N. For example, sst$ptl +30 
are resolved to be the SEGNO for sst_seg with the offset of ptl plus 
30 octal locations; sst$ptl+30 is also valid. 



Indirection: A VIRTUAL-ADDR can imply indirection. The indirect word can be usee 
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virtual address 



as an ITS pair if it is a valid ITS word pair; if not, the upper 
half of the word is used. The following VIRTUAL-ADDR construct is 
used to specify indirection (sst$cmp,*). The format of an indirect 
pointer value is: 

segno I offset,* segname j of f set , * symbol,* 

tempjptr , * tempjptr | offset , * 



Examples of indirection: 

17 1 230,* sstl230,* sst$cmp,*+2 

sp,* sp|230,* 
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08/15/83 why 



Syntax: why 



Fimction: The why request will try to find the stack that has a call to 
syserr__real$syserr_real or call_bce$call_bce and set the temporary 
pointers, pr6 and prfr, to the stack frame. This command will search 
the stacks for a frame that has a retum__to__ring__0_ frame and set the 
temporary pointers from this set of machine conditions that called this 
entry. 



Notes: If the crash was due to f im_util$check_fault finding a problem, the 
machine condition CU data is displayed and all temporary pointers are 
set from these machine conditions. If this was an Execute Fault then 
some lock info is printed an the process selected is lock ordered. 
First sst_seg$ptl followed by sst_seg$aslt then scs$connect_lock next 
tty__buf$ slock and last tty_buf$timer_lock. 

If this fdump was due to a manual return to BOS then some pertinent lock 
info will also be printed. 
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DAIA FORMATS 



INSTRUCTION FORMAT 



Address 



18 



1 1 



Opcode 



10 



2 2 2 3 3 
7 8 9 0 5 

"ill I 
|I|A| TAG I 

_LI_I I 

11 6 



ACCUMULATOR REGISTER (A) 



A-Upper (au) 



18 



1 1 

I " 
I 



A- Lower (al) 



18 



QUOTIENT REGISTER (Q) 



Q-Upper (qu) 



1 1 
I " 



Q-Lower (ql) 



18 18 
ACCUMULATOR.QUOTIENT REGISTER (AQ) 



Even Word (A) 



36 



3 3 
5 6 



I Odd Word (Q) 



36 



EXPONENT REGISTER (E) 



Exponent 
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EXPONENT -ACGUMUIATOR- QUOTIENT REGISTER (EAQ) 



0 0 
7 8 



64 



INDEX REGISTER (Xn) 

0 1 
0 7 



18 



POINTER REGISTER (PRn) 
or 

ITS POINTER FORMAT 



1 1 2 2 2 3 3 

7_8 0_1 9 0 5 

' i I I i 

I Segment Niunber | Ring | | (43) | 

I I I I I 



15 


3 






6 




5 5 


5 


5 


6 6 7 




3 4 


6 


7 


5 6 1 


Word Offset 


1 

1 
1 


1 
i 
1 


1 

1 Bit 

1 


1 1 
Off. 1 (TAG)j 

1 1 



0 0 0 
0 2 3 
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PACKED POINTER FORMAT 



0 0 0 1 1 3 
0 5_6 7_8 5 

ill I 
[Bit Off. (Segment Number | Word Offset { 

I I I I 



12 18 



INDIRECT WORD FORMAT 



0 11 3 3 
0 7_8 0 5 

1 I II 
I Address | Tally | Tag | 

I I I I 

18 12 3 
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/* format : s ty le4 , indattr , if then , indproc */ 



/* Demonstrate that an uninitialized ptr may be treated as an indirect 
word, causing accidental modifications in stack. */ 



indirect_word__demo : proc ; 



del uninitialized_j)ointer ptr; 

del basedvar based (uninitialized_pointer) ; 

del stackbaseptr builtin; 

del staek_first_word fixed bin (35) based (stackbaseptr ()); 

del ioa_ entry () options (variable); 

unspee (uninitialized_pointer) — "0"b; 

call ioa__ ("Word referenced as basedvar: ^w", basedvar); 
call ioa__ ("First word of stack: '^w", stack_f irstjword) ; 
call ioa_ ("Changing basedvar to -1."); 
basedvar — -1; 

call ioa_ ("Word referenced as basedvar: ^w" , basedvar); 
call ioa_ ("First word of stack: '^w", staek_f irst_word) ; 



end indirect_word_demo ; 



indirect_word_demo 

Word referenced as basedvar: 000000000004 
First word of stack: 000000000004 
Changing basedvar to -1. 

Word referenced as basedvar: 777777777777 
First word of stack: 777777777777 
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OCTAL FORMATS OF COMMON DATATYPES 

ITS Pointer 

000237400043 014040000000 
Null pointer 

077777000043 000001000000 
Unsnapped Link 
776772000046 000071000000 
Packed Pointer 
000237033036 
ASCII 

056165163145 162137157165 164160165164 040040040040 

Fixed Binary 1 

000000000001 

Fixed Binary -1 

777777777777 

Fixed Binary 0 

000000000000 

Clock value 

000000113267 753151076614 
UIDs 

101731476312 
132643613643 

Process ID 

025700556327 

Instructions 

600534252100 600504621100 030000431007 600044370120 
400062352120 000622700100 600303236100 600534252100 
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Processor Instructloiis 

Mnemonic Meaning 



a4bd Add 4-bit character displacement to AR 

a6bd Add 6 -bit character displacement to AR 

a9bd Add 9 -bit character displacement to AR 

aarN Alphanumeric descriptor to ARn 

abd Add bit displacement to AR 

absa Abs address to A register 

ad2d Add using two decimal operands 

ad3d Add using three decimal operands 

ada Add to A register 

adaq Add to AQ register 

ade Add to £ register 

adl Add low to AQ register 

adla Add logical to A register 

adlaq Add logical to AQ register 

adlq Add logical to Q register 

adlxN Add logical to index N 

adq Add to Q register 

adwpN Add to word numeric field o£ FRn 

adxN Add to index N 

air A register left rotate 

als A register left shift 

ana AND to A register 

anaq AND to AQ register 

anq AND to Q register 

ansa AND to storage from A register 

ansq AND to storage from Q register 

ansxN AND to storage from index N 

anxN AND to index N 

aos Add one to storage 

araN ARn to alpha descriptor 

arl A register rig^t logical shift 

amN ARn to numeric descriptor 

ars A register right shift 

asa Add stored to A register 

asq Add stored to Q register 

asxN Add stored to index N 

awca Add with carry to A register 

awcq Add with carry to Q register 

awd Add word displacement to AR 

bed Binary- to -BCD 

btd Binary- to -dec 

call6 Call 

camp Clear associative memory paged 

cams Clear associative memory segmented 

cana Comparative and with A register 

canaq Comparative and with AQ register 

canq Comparative and with Q register 

canxN Comparative and with index N 

cioc Connect 

cmg Compare magnitude 
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cmk Compare masked 

cmpa Compare with A register 

cmpaq Compare with AQ register 

cmpb Compare bit strings 

cmpc Compare alphaniameric character strings 

cmpn Compare numeric 

cmpq Compare with Q register 

cmpxN Compare with index N 

cnaa Comparative not with A register 

cnaaq Comparative not with AQ register 

cnaq Comparative not with Q register 

cnaxN Comparative not with index N 

csl Combine bit strings left 

csr Combine bit strings right 

cwl Compare with limits 

dfad DP floating add 

dfcmg DP floating compare magnitude 

dfcmp DP floating compare 

dfdi DP floating divide inverted 

dfdv DP floating divide 

dfld DP floating load 

dfmp DP floating multiply 

dfrd DP floating round 

dfsb DP floating subtract 

dfst DP floating store 

dfstr DP floating store rounded 

dis Delay until interrupt signal 

div Divide integer 

drl Derail 

-dtb Dec -to -binary convert 

dufa DP unnormalized floating add 

dufm DP vmnormalized floating multiply 

dufs DP unnormalized floating subtract 

dv2d Divide using two decimal operands 

dv3d Divide tising three decimal operands 

dvf Divide fraction 

eaa Effective address to A register 

eaq Effective address to Q register 

easpN Effective address to segment number field of PRn 

eawpN Effective address to word and bit fields of PRn 

eaxN Effective address to index N 

epaq Effective pointer to AQ register 

epbpN Effective pointer at base to PRn 

eppN Effective pointer to PRn 

era XOR to A register 

eraq XOR to AQ register 

erq XOR to Q register 

ersa XOR to storage with A register 

ersq XOR to storage with Q register 

ersxN XOR to storage with index N 

erxN XOR to index N 

fad Floating add 

fcmg Floating compare magnitude 

fcmp Floating compare 

fdi Floating divide inverted 
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fdv 


Floating divide 


fid 


Floatiing load 


fmp 


Floating multiply 


fiieg 


Floating negate 


fno 




frd 


Floating round 


fsb 


Floating subtract 


^ 9 


T?! oat"? Ti Of Q t'OT'^ 


fstr 


Floating store rounded 


fszn 


Floating set zero and negative indicators 


£tb 


Gray- to -binary convert 


larN 


Load ARn 


Ibar 


Load address registeristers 


lea 


Load complement into A register 


Icaq 


Load complement into AQ register 


Icor 


Load central processor register 


Icq 


Load complement into Q register 


IcxN 


Load complement into index N 


Ida 


Load A register 


Idac 


Load A register and clear 


Idaq 


Load AQ register 


Idbr 


Load descriptor base register 


Ide 


Load E register 


Idi 




Idq 




Idqc 




Idt 


Load timer register 


IdxN 


Load index N 


llr 


Long left rotate 


lis 


Long left sliift 


Ipl 


Load pointers and lengths 


Ipri 


Load pointer registers from ITS pairs 


IpitdN 


Load pointer register N from paclced pointer 


I'D to 


Load page table pointers 


Iptr 


Load page table registers 


Ira 


Load ring alarm register 


Ires 


Load registers 


Irl 


T o" Tf" 1 ff n t" TnciPiil 


Irs 


L/)nB^ riffbt sbift 


Isdp 


Load segment descriptor pointers 


Isdr 


Load segment descriptor registers 


IxlN 


L^ad index N from lower 


mlr 


Move aluliaTiuine'rie left to T*'iB"'ht 


nonel 


Master mode entry 1 


inni62 


Master mode entry 2 




Master mode entry 3 


mme4 


Master mode entry 4 


mp2d 


Multiply using two decimal operands 


]iip3d 


Multiply using three decimal operands 


inpf 


Multiolv fraction 


wpy 


i'iUJL uxp JLjr XllUCgCjL 


mrl 


Move alphanumeric right to left 


mve 


Move alphanumeric edited 


nrvTi 


Move numeric 


invne 


Move numeric edited 
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mvt 


Move alphantoneric with translation 


narN 


Numeric descriptor to ARn 


neg 


Negate (A register) 


negl 


Negate long (AQ registerister) 


nop 


No operandation 


ora 


Or to A register 


oraq 


Or to AQ register 


orq 


Or to Q register 


orsa 


Or to storage from A register 


orsq 


Or to storage from Q register 


orsxN 


Or to storage from index N 


orxN 


Or to index N 


pulsl 


Pulse location 1 


puls2 


Pulse location 2 


qlr 


Q register left rotate 


qls 


Q register left shift 


qrl 


Q register right logical shift 


qrs 


Q register right shift 


reel 


Read calendar clock 


reu 


Restore control unit 


ret 


Return 


rmem 


Read memory controller mask 


rpd 


Repeat double 


rpl 


Repeat link 


rpt 


Repeat 


rscr 


Read system controller register 


rsw 


Read switches 


rtcd 


Return control double 


s4bd 


Subtract 4-bit displacement from AR 


s6bd 


Subtract 6 -bit displacement from AR 


s9bd 


Subtract 9 -bit displacement from AR 




O J A n 

dUUJte ASMl 


sareg 


Store address registers 


sb2d 


Subtract using two decimal operands 


sb3d 


Subtract using three decimal operands 


sba 


Subtract from A register 


sbaq 


Subtract from AQ register 


sbar 


Store base address register 


sbd 


Subtract bit displacement from AR 


sbla 


Subtract logical from A register 


sblaq 


Subtract logical from AQ register 


sblq 


Subtract logical from Q register 


sblxN 


Subtract logical from index N 


sbq 


Subtract from Q register 


sbxN 


Subtract from index N 


scd 


Scan character do\ible 


scdr 


Scan character double reverse 


scm 


Scan with mask 


scmr 


Scan with mask reverse 


scpr 


Store central processor register 


sou 


Store control unit 


sdbr 


Store descriptor base register 


smcm 


Set memory controller mask 


smic 


Set memory interrupt cells 


spbpN 


Store segment base pointer of PRn 
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spl Store pointers and lengths 

spri Store pointer registers as ITS pairs 

spriN Store FRn as an ITS pair 

sprpN Store pointer register N packed 

sptp Store page table pointers 

sptr Store page table registers 

sra Store ring alarm register 

sreg Store registers 

ssa Siibtract stored from A register 

sscr Set system controller register 

ssdp Store segment descriptor pointers 

ssdr Store segment descriptor registers 

ssq Subtract stored from Q register 

ssxN Subtract stored from index N 

sta Store A register 

stac Store A register conditional 

stacq Store A register conditional on Q register 

staq Store AQ register 

stba Store 9 -bit characters of A register 

stbq Store 9 -bit characters of Q register 

stcl Store instruction counter + 1 

stc2 Store instruction counter + 2 

stca Store 6 -bit characters of A register 

stcd Store control double 

stcq Store 6 -bit characters of Q register 

ste Store E register 

sti Store indicator register 

stq Store Q register 

stt Store timer register 

stxN Store index N 

stz Store zero 

swca Subtract with carry from A register 

swcq Subtract with carry from Q register 

swd Subtract word displacement from AR 

sxlN Store index N in lower 

szn Set zero and negative indicators 

sznc Set zero and negative indicators and clear 

sztl Set zero and truncation indicators with bit string left 

sztr Set zero and tmncation indicators with bit string right 

tct Test character and translate 

tctr Test character and translate reverse 

teo Transfer on exponent overflow 

teu Transfer on exponent underflow 

tmi Transfer on minus 

tmoz Transfer on minus or zero 

tnc Transfer on no carry 

tnz Transfer on nonzero 

tov Transfer on overflow 

tpl Transfer on plus 

tpnz Transfer on plus and nonzer 

tra Transfer 

trc Transfer on carry 

trtf Transfer on trimcation indicator off 

trtn Transfer on truncation indicator on 

tspN Transfer and set FRn 
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tss 


Transfer and set slave 


tsxN 


Transfer and set index N 


ttf 


Transfer on tally indicator off 


ttn 


Transfer on tally indicator on 


tze 


Transfer on zero 


Ufa 


Unnormalized floating add 


ufm 


Unnormalized floating multiply 


ufs 


Unnomalized floating sub 


xec 


Execute 


xed 


Execute double 
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SIGNALLING AND CBAWLOUTS 
RING 4 FAULT EXAMPLE 
1. PROGRAM My__PGM EXECUTING IN RING 4 
STACK 4 STACK 0 



PDS 



init_jproc_ 



listen 



cnid_processor_ 



my__pgm 



page_fault_data 



flm data 



signal_data 



condition name 



mc save area 
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RING 4 FAULT EXAMPLE 
2. PARITY FAULT OCCURS 
STACK 4 STACK 0 PDS 



j I I I page_f ault__data 

init_proc_ | | | | 

I I I FV/!_ 

listen I i j £lm i f im data 




>**MCs** 



cmd_j)rocessor_| | | | 

I I I I slgnal_data 

my_j)gm j j | j 



condition name 



mc save area 



A Parity Fault occurs while executing an instruction of my_j)gni. 
Transfer via Fault Vector to fim, storing Machine Conditions in 
pds$fim__data. 
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STACK 4 



RING 4 FAULT EXAMPLE 
3. FIM BEGINS FAULT HANDLING 
STACK 0 



PDS 





condition name 



mc save area 



Fim ptishes a stack frame and copies the Machine Conditions into it at 
offset 60 (octal) , turning on the signal bit in the stack frame to 
indicate that it is a "FIM Frame". 
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STACK 4 



RING 4 FAULT EXAMPLE 
4. FIM DECIDES TO SIGNAL CONDITION 
STACK 0 



PDS 



init_proc_ 
listen_ 
cmd_pr oces sor_ 



flm 
**MCs** 



(signaller) 



flm 
I 
I 
I 

+-• 



rim- 



page_fault_data 

fim__data 
(MCs) 



slgnal_data 
• ->**ilCs** 



condi t ion_name 
.>**"parity"** 



mc save area 



I I 

Fim decides to signal a condition as a result of the fault. To do so it 
copies the Machine Conditions to pds$signal data, puts the condition 
name in pds$condition_name , and calls signaller. (Signaller is shown on 
the Ring 0 stack to indicate that it is active, but in reality it does 
not push a stack frame . ) 
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STACK 4 



RING 4 FAULT EXAMPLE 
5. SIGNALLER FINDS ORIGINAL STACK 
STACK 0 



FDS 



init__proc_ 
listen 



cmd_proces sor__ 



iny__pgm 



retum__to_ring 
**MCs**<- - - 




+--. . 



signaller 
I 
I 

+ 



rim 
**MCs** 



page_fault__data 



fim^data 
(MCs) 



signal__data 
•- **MCs** 



condition__name 
** "par i ty " ** 



mc_save_area 
■ ->**MCs** 



Signaller uses the Machine conditions in pds$signal_data to find the 
stack the process was using when the fault occurred. It adds a FIM 
frame to that stack and copies the Machine Conditions there. The 
Machine Conditions are also copied into a slot in pds$mc_save__area, to 
be used later if the fault is restarted. 
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RING 4 FAULT EXAMPLE 
6. SIGNAL_ LOOKS FOR A CONDITION HANDLER 
STACK_4 STACK 0 



PDS 



+-> 



+-> 



+-> 



+-> 



I 

-K- 



init_j)roc_ 



listen 



cmd__processor_ 
my__pgm 



ret\im_to_ring 
**iiCs** 



signal_ 



page_fault_data 

fiin__data 
(MGs) 
slgnal__data 
(MCs) 



condition_name 
("parity") 



inc_save_area 
**MCs** 



Signaller transfers control to signal_ in the original ring. Signal_ 
pushes a stack frame and then searches back through the stack frames 
looking for a handler. 
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STACK 4 



RING 4 FAULT EXAMPLE 
7. SIGNAL__ CALLS CONDITION HANDLER 
STACK 0 



PDS 



initjproc_ 



listen 



cmdj)rocessor_ 



retum__to__ring 
**MCs** 



signal_ 



nanaxer 



page_f aul t_da ta 



fim__data 

(MCs) 



signal_data 
(HCs) 



condition_name 
("parity") 



mc_save_area 
**MCs** 



Signal_ invokes the condition handler, 
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FAULT RESTART EXAMPLE 
1. HANDLER DECIDES TO RESTART FAULT 
STACK 4 STACK 0 



PDS 



init__proc_ 
listen 



cmd_processor_ 
my^pgm 



return__to_ring_ 
**MCs** 



signal_ 



Handler returns to its caller, i.e. to signal__. 



page_fault_data 

fiin_data 
(HCs) 
signal__data 
(MCs) 



condition_name 
("parity**) 



mc__s ave_ar ea 
**MCs** 
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FAULT RESTART EXAMPLE 
2. SIGNAL_ "RETURNS" TO RETURN_TO_RING__0_ 
STACK 4 STACK 0 



PDS 



init_proc_ 



listen 



cmd_processor__ 



iiiy__pgm 



I retum__to_ring 
**MCs** 



page_f aul t_da t a 



fim__data 
(MCs) 



signal_data 
(MCs) 



condition_Tiame 
("parity") 



mc save area 



**MCs** 



Signal_ performs a normal return, i.e. it transfers control to the 
address indicated in the return pointer of the previous stack frame. 
The previous stack frame was actually created by signaller, which called 
signal__. However, signaller put in a return pointer that points not 
to signaller, but to retum_to_ring_0_. Thus, signal_ transfers control 
to rettim__to__ring_0_. Retum_to__ring__0_ is a non- deciduous hardcore 
program with ring brackets of 0 0 7. It is therefore a gate into ring 0. 
All that it does when it starts executing in ring 0 is to call the ring 0 
program restart__fault. 
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STACK 4 



FAULT RESTART EXAMPLE 
3. RESTART_FAULT 
STACK 0 



PDS 



init_proc__ 
listen 



cmd_processor__ 



iny__pgm 



retum__to_ring_ 




page_fault_data 

fim_data 
(MCs) 



signal__data 
(MCs) 



c ondi t ion_name 
("parity") 



mc_save__area 
**MCs** 



Restart_fault gets the machine conditions from the return_to_ring_0_ FIM 
frame, and finds the corresponding conditions in pds$mc__save_area. It 
compares the two, and if no illegal changes have been made to the copy in 
the FIM Frame, it restarts those conditions. 
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STACK 4 



FAULT RESTART EXAMPLE 
4. FAULT IS RESTARTED 
STACK 0 



PDS 



iriit_proc_ 
listen 



cindjprocessor_ 



nry_pgm 



I page_f ault__data 



fiia_data 
(MCs) 



signal_data 
(MCs) 



condltion_naine 
("parity") 



mc save area 



(MCs) 



After fault is restarted, everything is back in its original state. 



F88, 9-11 



STACK 4 



FAULT ABANDONMENT EXAMPLE 
1. HANDLER IS UNWOUND 
STACK 0 



PDS 



init_j)roc__ 
listen 



cmdj>rocessor__ 



my_j>gm 



retum_to__ring_ 
**MGs** 



signal__ 



page_fault_data 

fim__data 
(HCs) 
signal_data 

(MCs) 



condi t ion_name 
("parity") 



mc__save_area 
**MCs** 



A non-local goto results in the handler's stack frame being unwound. 
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STACK 4 



FAULT ABANDONMENT EXAMPLE 
2. SIGNAL_ IS UNWOUND 
STACK 0 



PDS 



init__proc_ 
listen 



ciiid_proces sor_ 



iny_j)gm 



retum__to__ring 
**MCs** 



page__fault_data 



fim_data 
(MCs) 



sigiial_data 
(MCs) 



condition_nanie 
("parity") 



mc__save_area 
**MCs** 



Next, signal^'s stack frame is unwound. 
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FAULT ABANDONMENT EXAMPLE 
3, FXM FRAME'S CLEANUP HANDLER IS INVOKED 
STACK 4 STACK 0 



PDS 



init_proc_ 



listen 



cmd jprocessor__ 



retuini_to_ring__ 
**MCs** 




page_fault__data 



fiitt_data 
(MCs) 



signal_data 
(MCs) 



condi t ion_name 
( "parity" ) 



mc save area 



Restart_fault j 1 is the cleanup handler that signaller created for the 
retum__to__ring__0_ stack frame. When that stack frame is iinwoimd, 
restart_fault is invoked in ring 0. It finds the machine conditions in 
the FIM frame, and finds the corresponding conditions in 
pds$mc_save_area. It removes them from mc__save__area since they will 
never be restarted. 
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RING 0 FAULT EXAMPLE 

1. PROGRAM MY_PGM CALLS INTO RING 0 

STACK_4 STACK_0 PDS 

I I j I page_f ault_data 

init_proc__ | j hcs__ j j 

listen_ I I status_ | j fiin_data 

cmd_processor_| j | j 

. I I I I signal__data 

my_pgm j j | j 



condition name 



mc save area 
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STACK 4 



RING 0 FAULT EXAMPLE 
2. PARITY FAULT OCCURS 
STACK 0 



FDS 



initjproc_ 
listen 



cmd_processor_ 



my_j>gm 



hcs 



status 



FV/ 
fim 



+ 



page_f ault_data | 

fim_data 
•**MCs** 
signal_data 



condition name 



mc save area 



A Parity Fault occurs while executing an instruction of status_. 
Transfer via Fault Vecotr to fim, storing Machine Conditions in 
pds$fim__data. 
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STACK 4 



RING 0 FAULT EXAMPLE 
3. FIM BEGINS FAULT HANDLING 
STACK 0 



PDS 



init_j)roc_ 



listen 



cmdjprocessor^ 



my_j)gni 




condition name 



mc save area 



Fim pushes a stack frame and copies the Machine Conditions into it, 
turning on the signal bit in the stack frame to indicate that it is a 
"FIM Frame". 
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RING 0 FAULT EXAMPLE 



4. FIM DECIDES TO SIGNAL CONDITION 



STACK 4 


STACK 0 




PDS 




1 1 




(page fault da1ia| 


initproc | 


1 hcs 1 






listen_ 1 


1 status__ 1 




1 fim_data | 








1 **iiCs** 1 


ciiid_processor__ 1 


1 i 








1 **MCs** 


+ 


1 signal_data | 










myjpgm | 




+ 


->**MCs** 1 


i 


1 (signaller) | 

1 ! 




1 1 








1 condition_naine | 






fim — 


>**"parity"** | 








j ]nc__save_area j 











Fim decides to signal a condition as a result of the fault. To do so it 
copies the Machine Conditions to pds$signal data, puts the condition 
name in pds$condition_name , and calls signaller. (Signaller is shown on 
the Ring 0 stack to indicate that it is active, but in reality it does 
not push a stack frame.) 
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RING 0 FAULT EXAMPLE 



STACK 4 



5. SIGNALLER FINDS ORIGINAL STACK 
STACK 0 



FDS 



init_proc__ 



listen 



cmd_processor__ 



myjpgm 



hcs 



status 



fim 
**MCs** 



(signaller) 



re tum_t o_r ing_ 
0_ 

**MCs**< 



signaller 



page_f aul t__da ta 



fiin_data 
(MCs) 



signal_data 
**MGs** 



condition_name 
***'parity'*** 



iiic_s ave_ar ea 
•->**MCs** 



I 

Signaller uses the Machine conditions in pds$signal_data to find the 
stack the process was uising when the fault occurred. It adds a FIM 
frame to that stack and copies the Machine Conditions there. The 
Machine Conditions are also copied into a slot in pds$mc_save_area, to 
be used later if the fault is restarted. 



F88, 9-19 



RING 0 FAULT EXAMPLE 
6. SIGNAL_ LOOKS FOR A CONDITION HANDLER 
STACK 4 STACK 0 



PDS 



itiit__proc__ 
listen_ 
cmd_processor_ 
irry_pgni 



+-> 



+-> 



-K- 



hcs 



status 



fim 
**llCs** 



(signaller) 



return_to_ring 
0_ 
**MCs** 



signal^ 



page__f aul t_da ta 



fiin_data 
(MCs) 



signal__data 
(HCs) 



condition_name 
("parity") 



mc__s ave_ar ea 
**MCs** 



Signaller transfers control to signal__ in the original ring. Signal__ 
pushes a stack frame and then searches back through the stack frames 
looking for a handler. 
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RING 0 FAULT EXAMPLE 



7, SIGNAL_ DECIDES TO LEAVE RING 0 
STACK 4 STACK 0 PDS 



init_j)roc_ 



listen 



cmd_processor_ | 



my__pgm 



+-> 



+-> 



+<- 



hcs 



status 



fim 
**MCs** 



(signaller) 



retum__to__ring 
**MCs** 



signal_ 



page__f aul t__da ta 

fiin_data 

(MCs) 



signal_data 
(MCs) 



condition_name 
f. ("parity") 



verify_lock 



mc save area 



**MCs** 



Signal^ does not find a handler for the condition on the ring 0 stack. 
To continue the search for a handler it must follow stack_frame.prey_sp 
in the stack frame for hcs_. This transition from an inner ring to an 
outer ring in signalling a condition is called a "crawlout". When 
crawling out of a ring, that ring's stack is abandoned, and the condition 
(and therefore the fault in this example) will not be restartable. 
Crawling out from ring 0 is a special case. The programs that were 
active in ring 0 at the time of the fault may have locked supervisor 
databases or may be in the middle of modifying supervisor data. To be 
sure that nothing in ring 0 is left in an inconsistent state, verify__lock 
is called before crawling out. 
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RING 0 FAULT EXAMPLE 



8. CRAWLOUT 

STACK__4 STACK_0 PDS 

page__fault__data 



£ii]i_data 
(MCs) 
signal_data 
(MCs) 



con<iition_naine 
("parity") 



mc__save_area 
**MCs** 

The ring 0 stack is abandoned, the condition is essentially re- signalled 
in ring 4, the handler is found and executed. 
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+-> 



+-> 



■K- 



init_proc_ 



listen 



cmd_j)rocessor__ 



Iliy_j)gm 



re tum_to__r ing 
**MGs** 



signal_ 



handler 



Fault Type: Unassigned 



26- Unassigned scu 564,* -> prds$sys_trouble_data (71 j 240) 

30 tra 464,* -> wlred__f im$imexp_fault ( 34 1 2310) 
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Fault Type: Execute 



15 Execute scu 536,* -> prds$sys_trouble__data (71 1 240) 

tra 436,* -> wired_fim$xec_fault (34 1 2274) 

Group 2 Fault. 
Definition: 

1. The EXECUTE pushbutton on the processor maintenance panel has 
been pressed. 

2. An external gate signal has been subsituted for the EXECUTE 
pushbutton . 

(The selection between the above conditions is made by settings 
of various switches on the processor maintenance panel.) 

Use in Multics: 

Used to force a system crash. 
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Fault Type: Execute 



Machine Conditions For System Trouble Data At prds | 240 
Time Stored - 02/10/83 1234.0 hfh Thu (111512461676151734) 



Pointer Registers 



PRO 


(ap) 


- 2401610 


1610 


PRl 


(ab) 


- 240 1 460 


|460 


PR2 


(bp) 


- 113 14500 


tc_data|4500 


PR3 


(bb) 


- 113|0 


tc__data|0 


PR4 


dp) 


- 15 12214 


ws_linkage | 2214 


PR5 


(lb) 


- 41 1 127 


bound tc_priv$pxss 1 127 


PR6 


(sp) 


- 76 11160 


prds 1 1160 


PR7 


(sb) 


- 76|0 


prds jo 



Processor Registers 

XO - 76 XI - 0 X2 - 0 X3 - 0 X4 - 0 X5 - 1 X6 - 146 X7 - 1 

A Register - 777777777777 Q Register - 460172500752 E Register - 0 

Timer Register - 117676224 Ring Alarm Register - 1 

SCU masks - 000000000014 000000000007 

SCU Data at prds j 270 

270 000041550022 000000000037 000032000000 000000000000 
001257100200 010150000000 001306235000 001306235000 

Execute Fault (37) 

At: 4111257 bound_tc__priv$pxss j 1257 
On: cpu a (#0) 
Indicators : cary , '"'bar 

APU Status: priv, sdwaram, sd-on, pt-on, fanp 
Instructions : 

137576 001306 2350 00 Ida 1306 

137577 001306 2350 00 Ida 1306 
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Fault Type: Timer Runout 



4 Timer Runout scu 510,* -> prds$fim_data (71 | 160) 

tra 410,* -> wired_fim$timer_r\mout ( 34 1 2324) 



Group 7 Fault 
Definition: 

The timer register has decremented to or through the value zero. 
If the processor is in privileged mode or absolute mode, 
recognition of this fault is delayed until a return to normal 
mode or BAR mode. Coxmting in the timer register continues. 

Use in Multics: 

Timer runouts are used by traffic control to interrupt processes 
as the end of their eligibility quantum, and to implement pre- 
empt sampling. A process running in ring zero does not give up 
eligibility. However, it remembers that the TRO occured by 
setting the ring alarm register. When the process leaves ring 
zero a ring alarm fault will occur and the process will give up 
its eligibility at that time. 
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Fault Type: Timer Runout 



Machine Conditions For Page Fault Data At pds|0 

Time Stored - 03/11/83 1704.3 hfh Fri (111557226670514660) 

Pointer Registers 

PRO (ap) - 270 1 7120 >sll>bound_sss_wired_$pll_operators_| 1362 

PRl (ab) - 244 1 16200 >pdd> BjLBfXcBBBBBBB>stack_4| 16200 

PR2 (bp) - 22 1 4000 baclcup_abs_seg 1 4000 

PR3 (bb) - 244 1 15234 >pdd> BjLBfXcBBBBBBB>stack__4| 15234 

PR4 dp) - 257 1 24102 >pdd> Bj LBfXcBBBBBBB> BBBJMj xJDHWnQq. area. linker 1 24102 

PR5 (lb) - 325 1 0 >pdd> BjLBfXcBBBBBBB> BBBJMjxJDgXCjX. temp 1 0 

PR6 (sp) - 244 I 16060 >pdd> BjLBfXcBBBBBBB>stack_4| 16060 

PR7 (sb) - 244 I 15360 >pdd> BjLBfXcBBBBBBB>stack__4| 15360 

Processor Registers 

XO - 0 XI - 100 X2 - 777773 X3 - 352 X4 - 0 X5 - 0 X6 - 17 X7 - 120 
A Register - 000000000000 Q Register - 000000010000 E Register - 0 
Timer Register - 777777751 Ring Alarm Register - 0 
SCU masks - 031460000014 631460000007 

SOU Data at pds|30 

30 400315170041 000000000011 400315000000 000000242000 
017775000240 001231000500 076615165440 000000165540 

Timer Runout Fault (11) 

At : 3 15 j 17 7 7 5 >t>bound_vol\ime_dumper__Sdmpr_output_ j 5 265 
On: cpu a (#0) 
Indicators : '^bar , mif 

APU Status: sdwamm, sd-on, ptwamm, pt-on, fap 

CU Status: rfi, fif 

Instructions: 

636336 076 615 165 440 tctr (rl) ,enablefault,fill(076) 

636337 000 000 165 540 tctr (pr,rl) , fill (000) 

BIS Pointers and Lengths 

50 000400001040 000400001040 005571000070 000000006740 
005735000030 000077777040 000256000030 000077777734 
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Fault Type: Timer Runout 



Machine Conditions For Page Fault Data At pds|0 

Time Stored - 02/09/83 2111.2 hfh Wed (111511625250263542) 



Pointer Registers 



PRO (ap) - 67 1 1136 

PRl (ab) - 104)244 

PR2 (bp) - 113 1 3300 

PR3 (bb) - 113 1 3100 

PR4 dp) - 15 1 3100 

PR5 (lb) - 76 1 1153 

PR6 (sp) - 77777 1 1 

PR7 (sb) - 67|0 



in2r_stkO | 1136 
scs 1 244 
tc_data|3300 
tc_data|3100 
ws_linkage | 3100 
prds 1 1153 
NULL POINTER 
Inzr stkOiO 



Processor Registers 



XO - 1 XI - 2 X2 - 200 X3 - 0 X4 - 2 X5 - 60 X6 - 3 X7 - 0 

A Register - 000000777777 Q Register - 777777000000 E Register - 0 

Timer Register - 777777760 Ring Alarm Register - 0 

SCU masks - 031460000014 631460000007 



SOU Data at pds|30 



30 000065550021 000000000011 400260000200 000000000000 
000263100200 001266000500 000262710200 400064214320 

Timer Runout Fault (11) 

At: 65 1 263 inlt_j)rocessor 1 263 

On: cpu c (#2) 

Indicators : cary , '^bar 

APU Status: priv, sdwamm, sd-on, pt-on, fanp 

CU Status: rfi, fif 
Instructions : 

452236 000262 7102 00 tra 262 interrupt inhibit 

452237 4 00064 2143 20 sznc pr4|64,* interrupt inhibit 
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Fault Type: Gonaecl: 



8 Connect scu 520,* -> prds$fiin_data (71 1 160) 

tra 420,* -> prds$fast_connect_code (71 j 1054) 

Group 7 Fault 
Definition: 

A connect signal ($CON strobe) has been received from a system 
controller. This event is to be distinguished from a Connect 
Input/Output Channel (cioc) instruction encountered in the 
program sequence. 

Use in Multics: 

Used for all interprocessor signalling. Occtirs when one CPU 
executes a cioc instruction to "send a connect" to another CPU, 
or to itself. 

There are four types of interprocessor communication in Multics: 

1. Tell another CPU to clear its cache memory (Level 68 only) or 
its associative memory. 

2. To pre-empt a process running on another CPU if pre -empty 
sampling is not in use. 

3. To tell a CPU that the system is crashing. 

4. To tell a CPU that it is being deconfigured, due to delcpu 
command or a shutdown. 

Zones in the segment scs are used to indicate what type of 
connect is being sent to a CPU. prds$fast_connect_code handles 
the cache/AH clearing case, others are sent on to wired_fim. 
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Fault Type: Connect 



Machine Conditions For System Trouble Data At prds|240 
Time Stored - 02/09/83 2111.4 hfh Wed (111511625326645425) 

Pointer Registers 

PRO (ap) - 270 1 7120 >sll>boimd__system_control__$sc_j)arse_|4126 

PRl (ab) - 244 I 11016 >pdd> zzzzzzzbBBBfiBB>stack_4 f 11016 

PR2 (bp) - 244 1 15270 >pdd> zzzzzzzbBBBBBB>stack_4 1 15270 

PR3 (bb) - 360 1 1425 >scl>as_meter_table 1 1425 

PR4 (Ip) - 257 1 31154 >sll>bound_fsim_ 

PR5 (lb) - 257 1 33250 >sll>bound_fsim_ 

PR6 (sp) - 244 1 10620 >pdd> zzzzzzzbBBBBBB>stack_4| 10620 

PR7 (sb) - 360 1 2016 >scl>as_meter__table 1 2016 

Processor Registers 

XO - 1416 XI - 36466 X2 - 174 X3 - 4 X4 - 136 X5 - 1 X6 - 777777 X7 ■ 
A Register - 000000000000 Q Register - 000000000012 E Register - 107 
Timer Register - 000044726 Ring Alarm Register - 0 
SCU masks - 031460000014 631460000007 

Fault Register - 000400000000 ($CON A) 

SCU Data at prds|270 

270 400270050011 000000000021 400253000207 000000000000 
036040400200 007524000500 000001316007 000001316007 

Connect Fault (21) 

At: 270(36040 >sll>bound_system__control_ 

On: cpu c (#2) 

Indicators : zero , ''bar 

APU Status: sd-on, pt-on, fabs 

CU Status: rfi, fif 

Instructions : 

25676 000001 3160 07 canq l,dl 

25677 000001 3160 07 canq l.dl 
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PRO 


(ap) 


- 270 17120 


PRl 


(ab) 


- 244 152400 


PR2 


(bp) 


- 244 152506 


PR3 


(bb) 


- 244 143560 


PR4 


dp) 


- 456 116303 


PR5 


(lb) 


- 244 143560 


PR6 


(sp) 


- 244 153040 


PR7 


(sb) 


- 257 1110242 



Fault Type: Goxmect 



Machine Conditions For Signal Data At pds{140 

Time Stored - 03/17/83 1531.7 hfh Thu (111566603700510407) 

Pointer Registers 

>sll>bound_sss_wired__$pll_operators_ | 1362 
>pdd> BWbBhXGBBBBBBB>stack_4|52400 
>pdd> BVbBhXGBBBBBBB>stack_4 j 52506 
>pdd> BWbBhXGBBBBBBB>stack_4 | 43560 

>udd>Croap>lib>executable>bound_pascal_runtiine_$pascal_io_ 1 163 
>pdd> BWbBhXGBBBBBBB>stack_4 \ 43560 
>pdd> BWbBhXGBBBBBBB>stack_4|53040 
PR7 (sb) - 257 1110242 >pdd> BWbBhXGBBBBBBB> BBBJMkWLfGMqHm. area. linker | 110242 

Processor Registers 

XO - 4147 XI - 54640 X2 - 150732 X3 - 151116 X4 - 151116 X5 - 22 X6 - 71 X7 - 2220 
A Register - 777777777775 Q Register - 000000000000 E Register - 0 
Timer Register - 000143044 Ring Alarm Register - 0 
SOU masks - 000240000043 000340000000 

Fault Register - 000400000000 ($CON A) 

SCU Data at pds|170 

170 400456174043 000000000021 400456000100 000037000000 
016305100200 016305000500 000000066500 000000066500 

Connect Fault (21) 

At : 456 ! 16305 >udd>Croap>lib>executable>bo\indjpascal_runtime_$pascal__io_| 16305 
On: cpu b (#1) 
Indicators: cary, '^bar 

APU Status: sdwamm, sd-on, ptwanm, pt-on, pi-ap, fap 
CU Status: rfi, fif 
Instructions : 

53676 000 000 066 500 cmpb (pr) , () , f ill(O) 

53677 000 000 066 500 cmpb (pr) , () ,fill(0) 

EIS Pointers and Lengths 

210 000400000000 000400000000 043617410030 010477777760 
151040000030 000000000000 054156000000 000000000077 
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Fault Type: Connect 



Machine Conditions For Signal Data At pds|140 
Time Stored - 03/17/83 1528.6 hfh Thu (111566602375501317) 

Pointer Registers 

PRO (ap) - 270 1 7120 

PRl (ab) - 104 1 244 

PR2 (bp) - 244 1 4000 

PR3 (bb) - 113 1 0 

PR4 dp) - 14 1 12276 

PR5 (lb) - 75 1 3714 

PR6 (sp) - 244 1 4000 

PR7 (sb) - 244|0 

Processor Registers 

XO - 577777 XI - 4 X2 - 0 X3 - 400000 X4 - 0 X5 - 127 X6 - 120 X7 - 1 
A Register - 040000000000 Q Register - 000000000004 E Register - 0 
Timer Register - 000141001 Ring Alarm Register - 0 
SCU masks - 000240000043 000340000000 

Fault Register - 000400000000 ($CON A) 

SCU Data at pds|170 

170 400253170041 000000000021 400253000200 000007000000 
000250500200 000246000500 600101116100 600101116100 

Connect Fault (21) 

At : 253 1 250 >sll>bound_command_loop_$ipc_f ast_ 1 206 
On: cpu c (#2) 

Indicators: zero, cary, '^^bar 

APU Status: sdwamm, sd-on, ptwamm, pt-on, f sp 

CU Status: rfi, fif 

Instructions : 

750076 6 00101 1161 00 cmpq pr6|101 

750077 6 00101 1161 00 cmpq pr6|101 



>sll>bound_sss_wired_$pll_operators_ 1 1362 
scs 1 244 

>pdd> BlLBhbjbBBBBBB>stack__4|4000 
tc_data|0 
as^linkage | 12276 
pds 1 3714 

>pdd> BlLBhb j bBBBBBB>s tack_4 1 4000 
>pdd> BlLBhbjbBBBBBB>stack_4|0 
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Fault Type: Connect 



Machine Conditions For System Trotible Data At prds|240 
Time Stored - 03/17/83 1533.7 hfh Thu (111566604603067407) 

Pointer Registers 

PRO (ap) - 76 1 3176 

PRl (ab) - 104 1 244 

PR2 (bp) - 36 1 454 

PR3 (bb) - 17|0 

PR4 (Ip) - 15 1 1424 

PR5 (lb) - 15 1 1424 

PR6 (sp) - 76 1 3120 

PR7 (sb) - 76|0 

Processor Registers 

XO - 6111 XI - 3176 X2 - 0 X3 - 0 X4 - 0 X5 - 0 X6 - 213 X7 - 4 
A Register - 700000000000 Q Register - 000000000000 E Register - 0 
Timer Register - 775232216 Ring Alarm Register - 1 
SCU masks - 000000000014 000000000007 

Fault Register - 000400000000 ($CON A) 

SCU Data at prds|270 

270 000036750021 000000000021 400300000000 000000440000 
000247200200 001266000700 000061015200 000000235007 

Connect Fault (21) 

At : 36 1 247 bound_j)riv_l$privileged_mode__ut j 247 
On: cpu a (#0) 
Indicators: neg, '^bar 

APU Status: priv, xsf, sdwamm, sd-on, pt-on, fanp 
CU Status: rfi, its, fif 
Instructions : 

422076 000061 0152 00 cioc 61 interrupt inhibit 

422077 000000 2350 07 Ida 0,dl 



prds|3176 
scs i 244 

botind__priv__l$privilegedjiiode__ut 1 454 

sst_seg|0 
ws_linkage | 1424 
ws_linkage j 1424 
prds|3120 
prdsjo 
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Fault Type: Connect 



Machine Conditions For Fim Data At prds|160 

Time Stored - 02/09/83 2212.8 hfh Wed (111511660674665306) 



Pointer Registers 



PRO 


(ap) 


- 76 11420 


prds 1 1420 


PRl 


(ab) 


- 76 1 336 


prds 1 336 


PR2 


(bp) 


- 75 1 140 


pds|140 


PR3 


(bb) 


- 113 |0 


tc__data|0 


PR4 (Ip) 


- 15 1 312 


ws_linkage 1 312 


PR5 


(lb) 


- 1512214 


ws linkage] 2214 


PR6 


(sp) 


- 76 11160 


prds 1 1160 


PR7 


(sb) 


- 76|0 


prds jo 



Processor Registers 

XO - 203 XI - 1 X2 - 13740 X3 - 2270 X4 - 0 X5 - 2270 X6 - 344 X7 - 777776 
A Register - 000000000000 Q Register - 000000000000 E Register - 4 
Timer Register - 777737247 Ring Alarm Register - 0 
SCU masks - 000000000014 000000000007 

SCU Data at prds | 210 

210 000032750021 000000000021 000041000100 000000440000 
002505102200 002436000700 000063015200 777777710204 

Connect Fault (21) 

At: 32 1 2505 bound_interceptors$f im_util 1 53 
On: cpu b (#1) 

Indicators: cary, tro, "^bar 

APU Status: priv, xsf, sdwamm, sd-on, pt-on, fanp 
CU Status: rfi, its, fif 
Instructions : 

241016 000063 0152 00 cioc 63 interrupt inhibit 

241017 777777 7102 04 tra -l,ic 241016 interrupt inhibit 
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Fault Type 



Access Violation 



20 Access Violation 



sou 550,* 
tra 450,* 



> pds$fiin_data (70|60) 

> fiin$access__violation_entry (34 jO) 



Group 6 Fault 
Definition: 

The appending unit has detected one of the several access 
violations below. Word 1 of the Control Unit Data contains 
status bits for the condition. 

1. Not in read bracket (ACVS-ORB) 

2. Not in write bracket (ACV5-0WB) 

3. Not in execute bracket (ACVl-OEB) 

4. No read permission (ACV4-R-0FF) 

5. No write pemission (ACV6-W-0FF) 

6. No execute permission (ACV2— E-OFF) 

7. Invalid ring crossing (ACV12-CRT) 

8. Call limiter fault (ACV7-(N0 GA) 

9. Outward call (ACV9-0CALL) 

10. Bad outward call (ACVIO-BOC) 

11. Inward return (ACVll-INRET) 

12. Ring alarm (ACV13-^IALR) 

13. Associative memory error 

14. Out of segment bounds (ACV15-00SB) 

15. Illegal ring order (ACVO-IRO) 

16. Out of call brackets (ACV8-0CB) 

Use in Multics: 

The most -used type of access fault is the ring alarm fault. The 
supervisor uses the Ring Alarm Register, described by AL39: 

If the RALR contains a vlue other than zero and the 
effective ruing number is greater than or equal to the 
contents of the RALR and the instruction for which an 
absolute main memory address is being prepared is a transfer 
instruction, an access violation, ring alarm, fault occurs. 
Operating system software may use this register to detect 
crossings from inner rings to outer rings. 

A ring alarm fault is used for two purposes. 

1. Used by traffic control to defer loss of eligibility when an 
end- of -eligibility timer runout fault or a pre-empt connect fault 
occurs in ring 0. When the timer runout or connect is handled, 
the RALR is set to 1. 

2. Used to ensure that a process's validation level is set to a 
value at least equal to the new ring of execution when leaving an 
inner ring. 
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Fault Type: Access Violation 



An out of segment bounds fault may indicate a bounds fault, in 
which a segment has exceeded the maximum size for its AST pool 
and must be promoted to a bigger pool. 

All other types of access violation can be provoked by users. 
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Fault Type: Access Violation 



Machine Conditions For Fim Data At pds|60 

Time Stored - 02/09/83 2212.8 hfh Wed (111511660705216454) 



Pointer Registers 



PRO 


(ap) 


- 76 1 240 


prds 1 240 


PRl 


(ab) 


. 104 1 244 


scs 1 244 


PR2 


(bp) 


- 76 1 240 


prds 1 240 


PR3 


(bb) 


- 1|0 


f ault_vector | 0 


PR4 


dp) 


- 15 1 312 


ws_linkage 1 312 


PR5 


(lb) 


- 76 1 320 


prds i 320 


PR6 


(sp) 


- 76 11160 


prds 11160 


PR7 


(sb) 


- 76|0 


prds jo 



Processor Registers 

XO - 3036 XI - 2561 X2 - 4000 X3 - 0 X4 - 0 X5 - 0 X6 - 2 X7 - 100 
A Register - 000000000000 Q Register - 000000000000 E Register - 0 
Timer Register - 773613312 Ring Alarm Register - 0 
Fault Register - 010000000000 (COB) 

SCU Data at pds|110 

110 000032550022 004000000051 000032000017 000000000000 
010153410200 000120000007 000020057217 000020057217 

Access Violation Fault (51) , Write Bit Off 

By: 32)10153 bound^interceptors 

Referencing : 32 | 120 bound_interceptors$f im | 120 

On: cpu a (#0) 

Indicators: zero, eufl, '^bar 

APU Status: priv, sdwamm, sd-on, pt-on, fanp 

GU Status: 

CT Hold: dl 

Instructions : 

634216 000020 0572 17 sscr 20,7 interrupt inhibit 

634217 000020 0572 17 sscr 20,7 interrupt inhibit 
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Fault Type: Access Violation 



Machine Conditions For Signal Data At pdsjl40 

Time Stored - 02/10/83 1230.3 hfh Thu (111512460154130102) 

Pointer Registers 

PRO (ap) - 322 1 7120 >sll>bound_sss__wired_$pll__operators_| 1362 

PRl (ab) - 244 jo >pdd> zz22ZZzbBBBBBB>stack_4 1 0 

PR2 (bp) - 457126353 >t>bound_oprcons_$mrd_util_| 1 

PR3 (bb) - 244 1 774602 >pdd> zzzzzzzbBBBBBB>stack_4 1 774602 

PR4 (Ip) - 0|0 dsegjO 

PR5 (lb) - 244 1 774532 >pdd> zzzzzzzbBBBBBB>stack_4| 774532 

PR6 (sp) - 244 1 774620 >pdd> zzz2zzzbBBBBBB>stack_4| 774620 

PR7 (sb) - 244 1 774550 >pdd> zzz2ZZzbBBBBBB>stack_4 1 774550 

Processor Registers 

XO - 32017 XI - 774744 X2 - 174 X3 - 0 X4 - 0 X5 - 0 X6 - 0 X7 - 17 
A Register - 000002000000 Q Register - 000000000000 E Register - 0 
Timer Register - 000037431 Ring Alarm Register - 0 
SOU masks - 000102400043 000004000000 

Fault Register - 010400000000 (COB, $CON A) 

SCU Data at pdsI170 

170 400457050401 040000000051 400000000120 000000000000 
032025000200 001350000007 401350352120 401350352120 

Access Violation Fault (51), Not In Read Bracket 

By : 457 1 32025 >t>bound__oprcons_$mrd_util_ 1 3453 

Referencing: 0|1350 dseg|1350 

On: cpu b (#1) 

Indicators : "^bar 

APU Status: sd-on, pt-on, sdwp 

CU Status: 

CT Hold: dl 

Instructions : 

25576 4 01350 3521 20 epp2 pr4|1350,* 

25577 4 01350 3521 20 epp2 pr4|1350,* 
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Fault: Type: Access Violation 



Machine Conditions For Signal Data At pds|140 

Time Stored - 03/11/83 1704.2 hfh Fri (111557226651237015) 



Pointer Registers 



PRO 


(ap) 


- 40 17120 


bound_sss_wired_$pll_operators 


PRl 


(ab) 


- 104 1 244 


scs 1 244 


PR2 


(bp) 


- 230 145263 


tty buf 145263 


PR3 


(bb) 


- 7777711741 


CANNOT GET PATHNAME | 1741 


PR4 


dp) 


- 15 11616 


vs linkage 1 1616 


PR5 


(lb) 


- 230 145262 


tty_biif 145262 


PR6 


(sp) 


- 240 1 600 


>sll>stack_0 , 015 | 600 


PR7 


(sb) 


- 240 1 200 


>sll>stack_0 . 015 | 200 



Processor Registers 

XO - 30617 XI - 2 X2 - 777773 X3 - 500 X4 - 0 X5 - 4 X6 - 7 X7 - 460 
A Register - 777777007777 Q Register - 000000000174 E Register - 0 
Timer Register - 000122364 Ring Alarm Register - 0 
SCU masks - 000102000043 000004000000 

Fault Register - 010000000000 (GOB) 

SCtJ Data at pds|170 

170 000145052001 000004000051 477777000206 000000000000 
003427100200 001741000400 300000100440 040140100540 

Access Violation Fault (51) , Out of Segment Bounds 

By: 14513427 bound_tty_active$tty_write| 2033 

Referencing: 77777 | 1741 CANNOT GET PATHNAME j 1741 

On: cpu c (#2) 

Indicators: cary, ^bar 

APU Status: sd-on, pt-on, dsptw 

CU Status: rfi 

Instructions : 

536076 300 000 100 440 mlr (rl) , () ,fill(300) 

536077 040 140 100 540 mlr (pr ,rl) , (pr.rl) , fill (040) 

EIS Pointers and Lengths 

210 000400000000 000400000000 001741000070 002000000170 
001250000030 000000000000 002001000000 000077777735 
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Fault Type: Access Violation 



Machine Conditions For Fim Data At pds|60 

Time Stored - 02/10/83 1230.3 hfh Thu (111512460154134307) 
Pointer Registers 

PRO (ap) - 244 1 775732 >pdd> zzzzzzzbBBBBBB>stack_4| 775732 
PRl (ab) - 244 1 775240 >pdd> zzzzzzzbBBBBBB>stack__4 1 775240 
PR2 (bp) - 321 1 14521 >sll>boimd_sss_active_$sct_manager_| 15 
PR3 (bb) - 244 1 776040 >pdd> zzzzzzzbBBBBBB>stack_4| 776040 
PR4 (Ip) - 0|0 dseg|0 

PR5 (lb) - 244 1 775140 >pdd> zzzz2ZzbBBBBBB>stack_4| 775140 
PR6 (sp) - 2441775500 >pdd> zzzz22zbBBBBBB>stack__4| 775500 
PR7 (sb) - 244 I 0 >pdd> zzzzzzzbBBBBBB>stack_4 j 0 

Processor Registers 

XO - 17016 XI - 775732 X2 - 174 X3 - 0 X4 - 0 X5 - 0 X6 - 0 X7 - 160 
A Register - 000321000004 Q Register - 014521000000 £ Register - 0 
Timer Register - 000035274 Ring Alarm Register - 0 
Fault Register - 010000000000 (GOB) 

SOU Data at pdsjllO 

110 400322150201 000004000051 400244000100 000000000000 
017277100200 776060000000 300020652100 300020652100 

Access Violation Fault (51) , Out of Segment Bounds 

By: 322 1 17277 >sll>bound_sss_wired_$pll_operators_1 11541 

Referencing: 244 {776060 >pdd> zzzzzzzbBBBBBB>stack_4| 776060 

On: cpu b (#1) 

Indicators : cary , "^bar 

APU Status: sdwamm, sd-on, pt-on, ptw 

Instructions : 

25516 3 00020 6521 00 spri6 pr3|20 

25517 3 00020 6521 00 spri6 pr3|20 
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Fatilt Type: Access Violation 



Machine Conditions For Elm Data At pds|60 

Time Stored - 02/09/83 2212.7 hfh Wed (111511660666116070) 
Pointer Registers 

PRO (ap) - 270 1 7120 >sll>bo\md_sss_wired_$pll_operators_| 1362 

PRl (ab) - 244 1 143701(6) >pdd> BLlBLDPBBBBEBB>stack_4| 143701 

PR2 (bp) - 244 1 260000 >pdd> BLlBLDPBBBBBBB>stack__4 1 260000 

PR3 (bb) - 244 I 120740(3) >pdd> BLlBLDPBBBBBBB>stack_4| 120740 

PR4 (Ip) - 257 1 30034 >pdd> BL1BLDPBBBBBBB> BBBJMgffUXLPh. area. linker j 30034 

PR5 (lb) - 244 1 71220 >pdd> BLlBLDPBBBBBBB>stack_4 1 71220 

PR6 (sp) - 244 1 257640 >pdd> BLlBIDPBBBBBBB>stack_4| 257640 

PR7 (sb) - 244 I 106140 >pdd> BLlBLDPBBBBBBB>stack_4j 106140 

Processor Registers 

XO - 17053 XI - 106662 X2 - 272 X3 - 15 X4 - 1 X5 - 172 X6 - 50 X7 - 447 
A Register - 000000000045 Q Register - 777777777777 E Register - 0 
Timer Register - 777774627 Ring Alarm Register - 1 
Fault Register - 010000000000 (COB) 

SCU Data at pds|110 

110 400272050401 000020000051 400272000200 000000000000 
017204300200 017204010624 017204613200 000116100600 

Access Violation Fault (51) , Ring Alarm 
By : 272 1 17204 >udd>Attrisem>Jourdan>mes\ires>0RDA4 1 17204 
Referencing : 272 1 17204 >udd>Attrisein>Jotirdan>mesures>0RDA4 j 17204 
On: cpu c (#2) 

Indicators: neg, cary, ''bar 
APU Status: sd-on, pt-on, sdwp 
CU Status: pon, rfi, its 
CT Hold: ic* 

Instructions : 

243716 017204 6132 00 rcu 17204 interrupt inhibit 

243717 000 116 100 600 mlr (), (pr,x6) ,f 111(000) 
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Fault Type: Access Violation 



Machine Conditions For Fim Data At pds j 60 

Time Stored - 02/10/83 1230.3 hfh Thu (111512460156271332) 

Pointer Registers 

PRO (ap) - 27017120 

PRl (ab) - 76 1 336 

PR2 (bp) - 244 1 26020 

PR3 (bb) - 113 1 0 

PR4 (Ip) - 14 1 12276 

PR5 (lb) - 75 1 3714 

PR6 (sp) - 244 1 26020 

PR7 (sb) - 244|0 

Processor Registers 

XO - 577777 XI - 4 X2 - 0 X3 - 400000 X4 - 0 X5 - 127 X6 - 120 X7 - 1 
A Register - 040000000000 Q Register - 000000000000 E Register - 0 
Timer Register - 000166755 Ring Alarm Register - 1 
Fault Register - 010000000000 (GOB) 

SCU Data at pds | 110 

110 000040250401 000020000051 400301000100 000000672000 
015436000200 001266010200 001266610000 600076757100 

Access Violation Fault (51) , Ring Alarm 

By : 40 1 1543 6 bound_sss__wired_$pll_operators_ 1 7700 

Referencing: 301 1 1266 >sll>bound_ipc_$ipc_real_1 1266 

On: cpu b (#1) 

Indicators : ^bar 

AFU Status: xsf, sd-on, pt-on, sdwp 
CU Status: pon, its 
Instructions : 

674016 001266 6100 00 rtcd 1266 

674017 6 00076 7571 00 staq pr6|76 



>sll>bound_sss_wired__$pll__operators_ j 1362 
prds 1 336 

>pdd> CBBBLLzbBBBBBB>stack_4 j 26020 
tc_data|0 
as_linkage | 12276 
pds 1 3714 

>pdd> CBBBLLzbBBBBBB>stack_4i 26020 
>pdd> CBBBLLzbBBBBBB>stack_4 j 0 



F88, 10-20 



Fault Type: (DFl) Page 



17 (DFl) Page scu 542,* -> pds$page_fault_data (70 10) 

tra 442,* -> 44 j 1036 page_fault$page_fault (41 | 1062) 

Group 6 Fault 
Definition: 

A faulted segment descriptor word (SDW) or page table word (FTW) 
with the corresponding directed fault number has been fetched by 
the appending unit. 

Use in Multics: 

The only directed fault number ever found in PTWs in Multics is 
1. A Directed Fault 1 always means a page fault. 



F88, 10-21 



Fault Type: (DFl) Page 



Machine Conditions For Page Fault Data At pds|0 

Time Stored - 02/09/83 2212.7 hfh Wed (111511660647626100) 



Pointer Registers 

PRO (ap) - 322 1 7120 >sll>bound_sss_wired_$pll__operators_| 1362 

PRl (ab) - 244 I 12462 >pdd> zzzzzzzbBBBBBB>stack_4| 12462 

PR2 (bp) - 375133714 >t>bound oprcons_$write_log_|32 

PR3 (bb) - 433 1 1753 >scl>log| 1753 

PR4 (Ip) - 337 1 34352 >pdd> zzzzz2zbBBBBBB> BBBJMgffHxwhwg. area. linker 1 34352 

PR5 (lb) - 244 112374 >pdd> zzzzzzzbBBBBBB>stack_4| 12374 

PR6 (sp) - 244 1 12520 >pdd> zzzzzzzbBBBBBB>stack__4| 12520 

PR7 (sb) - 433 1 0 >scl>log|0 



Processor Registers 



XO - 33730 XI - 12374 X2 - 257 X3 - 1665 X4 - 0 X5 - 331 X6 - 30 X7 - 2000 
A Register - 000000000104 Q Register - 000000000000 E Register - 0 
Timer Register - 000154400 Ring Alarm Register - 0 
SCU masks - 031460000014 631460000007 

Fault Register - 010000000000 (GOB) 



SCU Data at pds|30 



30 400375150201 000000000043 400433000200 000000156000 
034305000240 002001000400 300000100440 040100100540 



(DFl) Page Fault (43) 

By : 375 1 34305 >t>bound__oprcons_$write_log_ 1 423 

Referencing: 433 [2001 >scl>log | 2001 

On: cpu c (#2) 

Indicators : ''bar , mif 

APU Status: sdwamm, sd-on, pt-on, ptw 

GU Status: rfi 

Instructions : 

20136 300 000 100 440 mlr (rl) ,(), f 111(300) 

20137 040 100 100 540 mlr (pr ,rl) , (pr) , fill (040) 



EIS Pointers and Lengths 



50 000400000000 000400000000 012502000060 772077777774 
001777000030 000000000040 012056000000 000000000077 



F88, 10-22 



Fault Type: Conimazid 



5 Conmand scu 512,* -> pds$f iin_data (70|60) 

tra 412,* -> fim$primary_fault_entry (34 j 404) 

Group 4 Fault 
Definition: 

1. The processor attempted to load or read the interrupt mask 
register in a system controller in which it did not have an 
interrupt mask assigned. 

2. The processor issued an XEC system controller command to a 
system controller in which it did not have an interrupt mask 
assigned. 

3. The processor issued a connect to a system controller port 
that is masked OFF. 

4. The selected system controller is in TEST mode and a 
condition determined by certain system controller maintenance 
panel switches has been trapped. 

5. An attempt was made to load a pointer register with packed 
pointer data in which the BITNO field value was greater than or 
equal to 60(8). 



Use in Multics: 

Entries in the UO/T are packed pointers initialized with bit 
offset values that provoke a command fault. 



F88, 10-23 



Fault Type: (DFO) Segment 



16 (DFO) Segment scu 540,* -> pds$f im__data (70|60) 

tra 440,* -> fim$primary_fault__entry (34 1 404) 

Group 6 Fault 
Definition: 

A faulted segment descriptor word (SDW) or page table word (PTW) 
with the corresponding directed fault number has been fetched by 
the appending unit. 

Use in Multics: 

The only directed fault number ever foimd in SDWs in Hultics is 
0. A Directed Fault Q. always means a segment fault. 



F88, 10-24 



Fault Type: (FT2) Linkage 



24 (FT2) Linkage scu 560,* -> pds$fim__data (70|60) 

tra 460,* -> fim$primary_fault_ent2:y (34 j 404) 

Group 5 Fault 
Definition: 

The corresponding indirect then tally variation has been detected 
during virtual address formation. 

Use in Hultics: 

A Fault Tag 2 occurs when a pointer is used that contains octal 
46 in the last six bits of the first word. All external 
references in Multics are made using links in the object segment. 
Such a link is a pointer with octal 46 as the tag. The linker is 
called to handle the fault by changing the link into a valid ITS 
pointer. 
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Fault Type: (FT2) Linkage 



Machine Conditions For Signal Data At pds|140 

Time Stored - 02/09/83 2212.7 hfh Wed (111511660664301450) 



Pointer Registers 



PRO (ap) - 270 1 7120 

PRl (ab) - 374 1 35642 

PR2 (bp) - 244 1 13406 

PR3 (bb) - 244 I 13300 

PR4 dp) - 257 1 35762 

PR5 (lb) - 257 1 5552 

PR6 (sp) - 244 I 13300 

PR7 (sb) - 244 1 0 



>sll>botmd_sss__wired_$pll_operators_ 1 1362 
>exl>continu\jun>bo\md_continuum_$con_reques t__table_ 1 0 
>pdd> BNLBU)fBBBBBBB>stack_4|13406 
>pdd> BNLBLDfBBBBBBB>stack_4|13300 

>pdd> BNLBLDfBBBBBBB> BBBJMgfjDqdxCN.area.linker| 35762 
>pdd> BNLBLDf BBBBBBB> BBBJMgf j DqdxCN , area . linker 1 5552 
>pdd> BNLBLDf BBBBBBB>stack_4 | 13300 
>pdd> BNLBLDf BBBBBBB>stack_4 1 0 



Processor Registers 



XO - 51443 XI - 14452 X2 - 36352 X3 - 36546 X4 - 1717 X5 - 0 X6 - 0 X7 - 36 
A Register - 000006000000 Q Register - 000000000000 E Register - 0 
Timer Register - 000004423 Ring Alarm Register - 0 



Sou Data at pds j 170 



170 400374250041 000000000061 400257000046 000001462000 
051501100200 036270000020 036270352020 400306352120 

(FT2) Linkage Fault (61) 

By : 374 1 51501 >exl>continuum>bound_continuum_$continu\an_command_ 1 361 

Referencing: 257 | 36270 >pdd> BNLBLDfBBBBBBB> BBBJMgf j DqdxCN. area. linker | 36270 

On: cpu a (#0) 

Indicators : cary , ''bar 

APU Status: xsf, sd-on, pt-on, fap 

CU Status: 

CT Hold: n* 

Instructions : 

735176 036270 3520 20 epp2 36270,* 

735177 4 00306 3521 20 epp2 pr4|306,* 



F88, 10-26 



Fault Type: Shutdown 

0 Shutdown scu 500,* -> pds$fim_data (70|60) 

tra 400,* -> fim$onc__start_shut__entry (34|14) 

Group 7 Fault 
Definition: 

An external power shutdown condition has been detected. DC POWER 
shutdown will occur in approximately one millisecond. 
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Fault Type: Op Not Complete 



11 Op Not Complete scu 526,* -> pds$fini_data (70|60) 

tra 426,* -> fim$onc_start__shut_entry (34|14) 

Group 2 Fault 

Any of the following will cause an operation not complete fault: 

1. The processor has addressed a system controller to which it 
is not attached, that is, there is no main memory interface port 
having its ADDRESS ASSIGNMENT switches set to a value including 
the main memory address desired. 

2. The addressed system controller has failed to acknowledge 
the processor. 3. The processor has not generated a main memory 
access request or a direct operand within 1 to 2 milliseconds and 
is not executing the Delay Until Interrupt Signal (dis) 
instruction. 

4. A main memory interface port received a data strobe without 
a preceding acknowledgement from the system controller that it 
had received the access request. 

5. A main memory interface port received a data strobe before 
the data previously sent to it was tmloaded. 
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Fault Type: Op Not Complete 



Machine Conditions For Fim Data At pds|60 

Time Stored - 02/12/83 0312.5 hfe Sat (111514443375723610) 



Pointer Registers 



PRO (ap) - 40 17120 
PRl (ab) - 240 1 4512 
PR2 (bp) - 240 1 1540 
PR3 (bb) - 227 1 16006 
PR4 dp) - 122 1 31131 
PR5 (lb) - 46 1 10 
PR6 (sp) - 240 1 3140 



bound__sss_wired_$pll_operators_ j 1362 
>sll>stack_0 . 019 | 4512 
>sll>stack_0 . 019 | 1540 
tty_bxif |16006 

bound_3 5 5_wir ed$ tty_space_man 1 5 25 

dn355_data|10 
>sll>stack_0 . 019 | 3140 



PR7 (sb) - 240 1 1400 >sll>stack_0.019| 1400 



Processor Registers 



XO - 31121 XI - 0 X2 - 777773 X3 - 500 X4 - 0 X5 - 0 X6 - 7 X7 - 460 

A Register - 000000000000 Q Register - 000000000137 E Register - 0 
Timer Register - 777766410 Ring Alarm Register - 1 



SCU Data at pds(110 



110 000122050011 000000000027 400300000006 000000000000 
015671000200 001266000000 700001352106 700001352106 



Op Not Complete Fault (27) 

By: 122 j 15671 boimd_355_wired$fnp_multiplexer j 4223 

Referencing: 300(1266 CANNOT GET PAHiNAME | 1266 

On: cpu a (#0) 

Indicators : ''bar 

APU Status: sd-on, pt-on, fabs 

Instructions : 

565416 7 00001 3521 06 epp2 pr7|l,ql 

565 



F88, 10-29 



Fault Type: Startup 



12 Startup scu 530,* -> pds$fim_data (70|60) 

tra 430,* -> f im$onc_start_shut_entry (34|14) 

Group 1 Fault 
Definition: 

DC POWER has been truned on. When the POWER ON button is 
pressed, the processor is first initialized and then the startup 
fault is generated. 



F88, 10-30 



Fault: Type: Parity 



9 Parity scu 522,* -> pds$fiin_data (70|60) 

tra 422,* -> fim$parity_entry (34 {124) 

Group 4 Fault 
Definition: 

1. The selected system controller has returned an illegal 
action signal with an illegal action code for one of the variotis 
main memory parity error conditions. 

2. A cache memory data or directory parity error has occxirred 
either for read, write, or block load. Cache status bits for the 
condition have been set in the cache mode register. 

3. The processor has detected a parity error in the system 
controller interface port while eitiier generating outgoing parity 
or verifying incoming parity. 
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Fault Type: Parity 



Machine Conditions For Fim Data At pds|60 

Time Stored - 03/06/83 1343.4 hfh Sun (111550652327420005) 



Pointer Registers 



PRO (ap) 

PRl (ab) 

PR2 (bp) 

PR3 (bb) 

M14 dp) 

PR5 (lb) 

PR6 (sp) 

PR7 (sb) 



76 1 240 
1041244 
75 1 60 
75 1 220 
15 1 312 
76 1 740 
76 1 1160 
76|0 



Processor Registers 



prds 1 240 
scs 1 244 
pds 160 
pds|220 

ws_linkage | 312 
prds 1 740 
prds I 1160 
prds 1 0 



XO - 46 XI - 0 X2 - 124155 X3 - 0 X4 - 0 X5 - 127 X6 - 0 X7 - 777774 
A Register - 000000000000 Q Register - 000000000000 E Register - 0 
Timer Register - 000114573 Ring Alarm Register - 0 



S(;u Data at pds j 110 



110 000032750021 000000170023 000172000000 000000000000 
001714001200 000000000224 001714710200 001676352220 



Parity Fault (23) 

Illegal Action Code (17) - Data Parity (SCU -> Store) 
By: 32 1 1714 botmd_interceptors$wired_fim| 16 
Referencing : 172 | 0 kst_seg | 0 
On: cpu a (#0) 
Indicators : par , ''bar 

APU Status: priv, xsf, sdvamm, sd-on, pt-on, fanp 
CU Status: its 
GT Hold: ic* 
Instructions : 

546016 001714 7102 00 tra 1714 interrupt inhibit 

546017 001676 3522 20 epp2 1676,* interrupt inhibit 



F88, 10-32 



Fault Type: Store 



1 Store scu 502,* -> pds$signal_data (70 | 140) 

tra 402,* -> fim$signal_entry (34 {300) 

Group 4 Fault 
Definition: 

The processor attempted to select a disabled port, an out-of- 
bounds address was generated in the BAR mode or absolute mode, 
an attempt was made to access a store unit that was not ready. 
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Fault Type: Store 



Machine Conditions For Signal Data At pds|140 
Time Stored - 03/29/83 1507.9 hfe Tue (111605613135576571) 

Pointer Registers 

PRO (ap) - 4017120 

PRl (ab) - 240 1 5000 

PR2 (bp) - 76 1 100 

PR3 (bb) = 172 1 1000 

PR4 dp) - 15 1 312 

PR5 (lb) - 144 1 13224 

PR6 (sp) - 240 1 3760 

PR7 (sb) - 152 1 0 

Processor Registers 

XO - 2237 XI - 4504 X2 - 2521 X3 - 777671 X4 - 2 X5 - 520 X6 - 514 X7 - 2747 

A Register - 000000000000 Q Register - 000172013277 E Register - 0 

Timer Register - 000137225 Ring Alarm Register - 0 

SCU masks - 000240000043 000340000000 

Fault Register ° 000200000262 ($CON B, CACHE-PAR lA) 

(Ilegal Action on CPU Port D: Store Not Ready ( 13)) 

SCU Data at pds|170 

170 000032550023 000000130003 000240000217 000000000000 
002747100200 013300000000 000000710217 000476710220 

Store Fault (3) 

Illegal Action Code (13) - Store Not Ready 
By : 32 1 2747 bound_interceptors$f im_util 1 315 
Referencing : 240 | 13300 >sll>stack_0 . 016 | 13300 
On: cpu c (#2) 

Indicators : cary , ''bar 

APU Status: priv, sdwamm, sd-on, pt-on, fanp 
Instructions : 

470576 000000 7102 17 tra 0,7 interrupt inhibit 

470577 000476 7102 20 tra 476,* interrupt inhibit 



bound_sss__wired__$pll__operators_ 1 1362 

>sll>stack_0 . 016 | 5000 

prds I 100 

kst_seg|1000 

ws__linkage 1 312 

bound_sy s tem_f aul ts$lock|3162 
>sll>stack__0 . 016 1 3760 
dirlockt__seg 1 0 
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Fault Type: Trouible 



31 Trouble scu 576,* -> pds$fim_data (70|60) 

tra 476,* -> fim$primary_fault_entry (34 1 404) 

Group 2 Fault 
Definition: 

The trouble fault is defined as the occurrence of a fault during 
the fetch or execution of a fault trap pair or interrupt trap 
pair. Such faults may be hardware generated (for example, 
operation not complete or parity) , or operating system generated 
(e.g. , the page containing a trap pair instruction operand is 
missing) . 
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Fault Type: Trouble 



Machine Conditions For Fim Data At pds|60 

Time Stored - 03/29/83 1507.8 hfe Tue (111605613070163325) 



Pointer Registers 



PRO (ap) - 270 1 7120 
PRl (ab) - 244 I 104760 
PR2 (bp) - 2441106760 
PR3 (bb) - 422 1 61224 
PR4 (Ip) - 257 1 54074 
PR5 (lb) - 427 1 367314 
PR6 (sp) - 244 1 102620 
PR7 (sb) - 427 1 17524 



>sll>bound_sss__wired_$pll_operators_| 1362 
>pdd> BdbBGBpbBBBBBB>stack__4 1 104760 

>pdd> BdbBCBpbBBBBBB>stack_4 1 106760 

>pdd> BdbBCBpbBBBBBB> BBBJMlPcJljbLc . area . compose | 61224 
>pdd> BdbBCBpbBBBBBB> BBBJMlPbxgCHhJ . area . linker | 54074 
>pdd> BdbBCBpbBBBBBB> BBBJMlPcKDQCdK . area . compose | 367314 
>pdd> BdbBCBpbBBBBBB>stack_4 | 102620 

>pdd> BdbBCBpbBBBBBB> BBBJMlPcKDQCdK . area . compose 1 17524 



Processor Registers 



XO - 1757 XI - 102104 X2 ~ 32 X3 - 777732 X4 - 2 X5 
A Register - 000000000001 Q Register - 777777777777 
Timer Register - 000037651 Ring Alarm Register - 1 
Fault Register - 010000000000 (GOB) 



- 0 X6 - 61 X7 
E Register - 0 



2140 



SCU Data at pdsjllO 



110 000032550022 000000130077 000000000000 000000000000 
002747100200 013300000000 000000000000 000000000000 



Trouble Fault (77) 

Illegal Action Code (13) - Store Not Ready- 
By: 3212747 bound_interceptors$f im_util I 315 
Referencing: 0| 13300 dseg| 13300 
On: cpu a (#0) 
Indicators: cary, ''bar 

APU Statiis: priv, sdwamm, sd-on, pt-on, fanp 
Instructions : 

470516 000000 0000 00 0 

470517 000000 0000 00 0 



FSB, 10-36 



Fault Type 



Directed Fault 2 



18 Directed Fault 2 



sou 544,* 
tra 444,* 



> pds$signal_data (70 | 140) 

> fim$signal_entry (341300) 



Group 6 Fault 
Definition: 

A faulted segment descriptor word (SDW) or page table word (FTW) 
with the corresponding directed fault number has been fetched by 
the appending unit. 



F88, 10-37 



Fault Type 



Directed Fault 3 



19 Directed Fault 3 



scu 546,* 
tra 446,* 



> pds$signal__data (70 1 140) 

> fim$signal__entry (34|300) 



Group 6 Fault 
Definition: 

A faulted segment descriptor word (SDW) or page table word (PTW) 
with the corresponding directed fault number has been fetched by 
the appending imit. 



F88, 10-38 



Fault T^e: Derail 

6 Derail scu 514,* -> pds$signal_data (70 | 140) 

tra 414,* -> fiin$drl_entry (34|30) 

Group 5 Fault 
Definition: 

The Derail instruction has been decoded. 
Use in Multics: 

Certain supervisor programs execute a DRL instruction rather than 
calling syserr to provoke a system crash. 
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Fault Type: Derail 



Bootload CPU Registers at Time of Diiinp 



Pointer Registers 



PRO (ap) - 76 1 240 

PRl (ab) - 104 1 245 

PR2 (bp) - 76 1 240 

PR3 (bb) - IjO 



prds 1 240 
scs i 245 
prds 1 240 



PR4 (Ip) - 15 1 312 

PR5 (lb) - 76 1 320 

PR6 (sp) - 76 1 1160 

PR7 (sb) - 76|0 



f ault_vector | 0 
ws__linkage 1 312 



prds 1 320 
prds j 1160 
prds 1 0 



Processor Registers 

XO - 3036 XI - 2561 X2 - 164654 X3 - 0 X4 - 0 X5 - 1770 X6 - 0 
A Register - 010340657200 Q Register - 010011630200 E Register 
Timer Register - 767652141 Ring Alarm Register - 0 
Descriptor Segment Base Register - 035444700000 017770000024 
Mode Register - 000000000021 
Cache Mode Register - 177532005003 

SOU Data 

3540 000032450001 000000000015 000032000000 000000000000 
003146101200 000000000000 000000002200 000000002200 

Derail Fault (15) 

By : 32 1 3146 bound_interceptors$sys_trouble 1 132 
Referencing: 32 1 0 bound__interceptors$f ira J 0 
On: cpu a (#0) 

Indicators: cary, par, "^bar 
APU Status: priv, sd-on, pt-on 
Instructions : 

3546 000000 0022 00 drl 0 interrupt inhibit 

3547 000000 0022 00 drl 0 interrupt inhibit 
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Fault Type: MME 1 

2 MME 1 scu 504,* -> pds$signal_data (70|140) 

tra 404,* -> fim$signal__entry (34 j 300) 

Group 5 Fault 
Definition: 

The corresponding Master Mode Entry instruction has been decoded. 



F88, 10-41 



Fault Type: Fault Tag 1 



3 Fault Tag 1 scu 506,* -> pds$signal_data (70 | 140) 

tra 406,* -> fim$slgnal_entry (34 | 300) 

Group 5 Fault 
Definition: 

The corresponding indirect then tally variation has been detected 
during virtual address formation. 

Use in Multics: 

A Fault Tag 1 occurs when a pointer is used that contains octal 
40 in the last six bits of the first word. There is no normal 
use of a Fault Tag 1 fault. It is almost always the result of a 
reference to an uninitialized pointer. Because the most common 
ASCII character is octal 040 (a blank) , an uninitialized pointer 
frequently has a tag of 40 if there was previously ASCII data in 
the zone used as a pointer. For this reason the error message 
when a Fault Tag 1 is signalled in the user process says "ASCII 
data where pointer expected." 
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Fault Type: Lockup 



7 Lockup sou 516,* -> pds$signal_data (70 | 140) 

tra 416,* -> fim$signal_entry (34j300) 

Group 4 Fault 

The program is in a code sequence which has inhibited sampling 
for interrupts (whether present or not) and group 7 faults for 
longer than the prescribed time. In absolute mode or privileged 
mode the lockup time is 32 milliseconds. In nomoial mode or BAR 
mode the lockup time is specified by the setting for the lockup 
time in the cache mode register. The lockup time is program 
settable to 2, 4, 8, or 16 milliseconds. 

While in absolute mode or privileged mode the lockup fault is 
signalled at the end of the time limit set in the lockup timer 
but is not recognized until the 32 millisecond limit. If the 
processor returns to normal mode or BAR mode after the fault has 
been signalled but before the 32 millisecond limit, the fault is 
recognized before any instruction in the new mode is executed. 
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Fault Type: Lockup 



Machine Conditions For Signal Data At pds|140 

Time Stored - 03/26/83 1429.1 hfh Sat (111602011334057774) 



Pointer Registers 



PRO 


(ap) 


- 6711136 


inzr__stkO j 1136 


PRl 


(ab) 


- 104 1 247 


scs 1 247 


PR2 


(bp) 


- 75160 


pds 1 60 


PR3 


(bb) 


- 75 1 220 


pds 1 220 


PR4 


dp) 


- 15 1 312 


ws_linkage j 312 


PR5 


(lb) 


- 76 1 340 


prds 1 340 


PR6 


(sp) 


- 7777711 


NULL POINTER 


PR7 


(sb) 


- 67|0 


inzr__stkO 1 0 



Processor Registers 

XO - 42 XI - 2561 X2 - 350 X3 - 4 X4 - 0 X5 - 32 X6 - 0 X7 - 0 

A Register - 500000154700 Q Register - 000000000000 E Register - 0 

Timer Register - 777737756 Ring Alarm Register - 0 

SCU Data at pds j 170 

170 000032450001 000000000017 000076000000 000000566000 
002651101200 002642000000 500000154600 200044716300 

Lockup Fault (17) 

By: 32 1 2651 bound_interceptors$f im__util 1 217 
Referencing: 76 | 2642 prds | 2642 
On: cpu a (#0) 

Indicators: cary, par, "^bar 
APU Status: priv, sd-on, pt-on 

Instructions : 

411176 500000 1546 00 sptr -300000 interrupt inhibit 

411177 2 00044 7163 00 xec pr2j44 interrupt inhibit 

EIS Pointers and Lengths 

210 000400000000 000400000000 001763000000 756077777735 
000000000000 000077777670 002005000000 000077777735 
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Fault Type: Illegal Procedure 



10 Illegal Procedixre scu 524,* -> pds$signal_data (70 | 140) 

tra 424,* -> fim$signal_entry (34 j 300) 

Group 5 Fault 
Definition: 

1. An Illegal operation code has been decoded or an illegal 
instruction sequence has been encountered. 

2. An illegal modifier or modifier sequence has been 
encountered during virtual address formation. 

3. An illegal address has been given in an instruction for 
^ich the ADDRESS field is used for register selection. 

4. An attempt was made to execute a privileged instruction in 
normal mode or BAR mode. 

5. An illegal digit was encountered in a decimal niomeric 
operand. 

6. An illegal specification was found in an EIS operand 
descriptor. 

The conditions for the fault will be set in the fault register, 
word 1 of the Control Unit Data, or in both. 
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Fault Type: Illegal Procedure 



Machine Conditions For Signal Data At pds|140 

Time Stored - 02/21/83 1235.6 hfh Mon (111530333460565000) 



Pointer Registers 



PRO (ap) - 75 1 560 

PRl (ab) - 221 1 260 

PR2 (bp) - 76 1 1660 

PR3 (bb) - 17|0 



pds|560 

syserr__daenion_stack| 260 

prds 1 1660 

sst_seg| 0 

ws__lirikage ] 762 

ws_linkage j 762 

prds 1 1420 

prds jo 



PR4 (Ip) - 15 1 762 

PR5 (lb) - 15 1 762 

PR6 (sp) - 76 1 1420 

PR7 (sb) - 76|0 



Processor Registers 

XO - 10 XI - 1110 X2 - 352 X3 - 200000 X4 - 1 X5 - 0 X6 - 2677 X7 - 2702 
A Register = 120000106664 Q Register = 000000000000 E Register - 0 
Timer Register - 000044167 Ring Alarm Register - 0 
Fault Register - 400000000000 (ILL OP) 

SCU Data at pds|170 

170 000035450001 200000000025 000035000020 000000000000 



Illegal Procedure Fault (25), Illegal Op Code 
By : 35 1 3042 bound_page_control$pos t_purge j 156 
Referencing: 35 | 10000 bound_page_control$pc | 146 
On: cpu a (#0) 

Indicators: zero, cary, ^bar 
APU Status: priv, sd-on, pt-on 
Instructions : 

667776 010001 0002 20 .... 10001,* interrupt inhibit 

667777 0 00005 2201 00 IdxO pr0|5 



003042500200 010000000000 010001000220 000005220100 
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Fault Type: Illegal Procedure 



Machine Conditions For Signal Data At pds|140 

Time Stored - 03/29/83 1508.0 hfe Tue (111605613146467522) 



Pointer Registers 

PRO (ap) - 40 1 7120 boiind_sss_wired__$pll_operators_|1362 

PRl (ab) - 230 1 5540 tty__buf 1 5540 

PR2 (bp) - 230 1 30354 tty_btif 1 30354 

PR3 (bb) - 46 1 100 dn355_data| 100 

PR4 dp) - 12212463 boimd_355_wired$dn355 1 2463 

PR5 (lb) - 230 127344 tty_buf| 27344 

PR6 (sp) - 76 1 1260 prds|1260 

PR7 (sb) - 5 1 410 dn355 mailbox 1 410 



Processor Registers 



XO - 2500 XI - 2040 X2 - 245576 X3 - 245560 X4 - 1730 X5 - 1104 X6 - 2254 X7 - 1300 
A Register - 400000000000 Q Register - 000000000102 E Register - 0 
Timer Register - 000364003 Ring Alarm Register - 1 
Fault Register - 400000000000 (ILL OP) 



SCU Data at pds|170 



170 000122050001 200000000025 000122000000 000000000000 
002500300200 000000000000 000000000000 000000000000 



Illegal Procedure Fault (25) , Illegal Op Code 
By: 12212500 bo\md_355_wired$dn355 1 2500 
Referencing: 12210 bound_355_wired$dn355 |0 
On: cpu a (#0) 

Indicators: neg, cary, '^bar 
APU Status: sd-on, pt-on 
Instructions : 

275276 000000 0000 00 0 

275277 000000 0000 00 0 
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Fatilt Type: Overflow 



13 Overflow sou 532,* -> pds$signal__data (70 | 140) 

tra 432,* -> fim$signal__entry (34 1 300) 

Group 3 Fault 
Definition: 

An arithmetic overflow, exponent overflow, exponent underflow, or 
EIS truncation fault has been generated. The generation of this 
fault is inhibited when the overflow mask indicator is ON. 
Resetting of the overflow mask indicator to OFF does not generate 
a fault from previously set indicators. The overflow mask state 
does not affect the setting, testing or storing of indicators. 
The determination of the specific overflow condition is by 
indicator testing by the operating supervisor. 
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Fault Type: Overflow 



Time Stored - 03/31/83 1752.0 hfe Thu (111610333767301724) 

Pointer Registers 

PRO (ap) - 40 1 7120 

PRl (ab) - 230 134220 

PR2 (bp) - 240 1 3520 

PR3 (bb) - 240 1 1420 

PR4 (Ip) - 123113240 

PR5 (lb) - 240 1 1424 

PR6 (sp) - 240 1 3140 

PR7 (sb) - 240 1 3512 

Processor Registers 

XO - 33115 XI - 3560 X2 - 777773 X3 - 500 X4 - 0 X5 - 4 X6 - 7 X7 - 500 
A Register - 400000000000 Q Register - 000000000000 E Register - 0 
Timer Register - 000115235 Ring Alarm Register - 0 
SCU masks - 000240000043 003140000000 

SCU Data at >sll>stack_0 . Oil | 4010 

4010 000123050011 000000000033 000244000200 000000000000 
014244340200 004136000000 000033735000 000011236007 

Overflow Fault (33) 

By: 123 1 14244 boiand_tincp_wired 

Referencing: 24414136 >pdd> BxbBDC]03BBBBBB>stack_4 j 4136 
On: cpu c (#2) 

Indicators: neg, cary, ovfl, '^bar 
APU Status: sd-on, pt-on, fabs 
Instructions : 

570716 000033 7350 00 als 33 

570 



bound__sss_wired_$pll__operators_ j 1362 
tty_buf 134220 
>sll>stack_0 . Oil 1 3520 
>sll>stack_0 . Oil 1 1420 
bound__tmcp__wired 
>sll>stack_0 . Oil 1 1424 
>sll>stack__0 . Oil 1 3140 
>sll>stack_0 . Oil 1 3512 
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Fault Type: Mlsc 



Divide Check 

14 Divide Check sou 534,* -> pds$signal_data (70 | 140) 

tra 434,* -> fim$signal_entry (34|300) 

Group 3 Fault 
Definition: 

A divide check fault occurs when the actual division cannot be 
carried out for one of the reasons specified with individual 
divide instructions. 

Fault Type: MME 2 

21 MME 2 scu 552,* -> pds$signal_data (70 j 140) 

tra 452,* -> fim$signal__entry (34 1 300) 

Group 5 Fault 
Definition: 

The corresponding Master Mode Entry instruction has been decoded. 

Fault Type: MME 3 

22 MME 3 scu 554,* -> pds$signal__data (70|140) 

tra 454,* -> fim$signal__entry (34|300) 

Group 5 Fault 
Definition: 

The corresponding Master Mode Entry instruction has been decoded. 
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Fault Type: Misc 



Fault Type: MME 4 

23 MME 4 scu 556,* -> pds$signal_data (70 1 140) 

tra 456,* -> f iiii$signal_entry (34 1 300) 

Group 5 Fault 
Definition: 

The corresponding Master Mode Entry instruction has been decoded. 

Fault Type: Fault Tag 3 

25 Fault Tag 3 scu 562,* -> pds$signal_data (70 j 140) 

tra 462,* -> fim$signal_entry (34 | 300) 

Group 5 Fault 
Definition: 

The corresponding indirect then tally variation has been detected 
during virtual address formation. 
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INTERRUPT TYPES 



lOM NUMBER 



A 


B 


C 


D 


1 0 


1 1 


1 2 


i 3 1 


1 ^ 


1 5 


1 6 


1 7 j 


i 8 


1 9 


1 10 


1 11 1 


! 12 


1 13 


1 1^ 


1 15 1 


i 16 


1 17 


1 18 


i 19 1 


i 20 


1 21 


1 22 


1 23 1 


1 24 


1 25 


1 26 


I 27 1 


1 28 

1 

1 


1 29 
1 


1 30 


I 31 1 



Not tised by lOMs; used by 
CPU to start another CPU 

System Fault; Error condition 
in lOM not reportable against 
a channel. 



- Terminate interrupt: 
I/O completion 



j - Marker interrupt : 
__| progress through I/O. 



I Special interrupt: 
I - device condition not 
_| resulting from I/O request. 
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OOHP ANALYSIS 
MBiaODOLOGiy 



Check diunp circum- 
stances (written) 



11 II 
1 1 Error? 1 1 



yes 



FIX OPERATIONAL 
PROCEDURES 



V no 



DetermLne 
Crash 
type 



Prohibited Fault 
I 

V 



Read f lagbox msg 



Follow sys_trouble 
PR2 to MCs 



Syserr 
V 



II— >|| 



yes 



Examine MCs in 
FIM frame 



lUdw 
Fault? 



terminate 
Inzr? 



yes 



Trace Initializers 
stack 4 



Read Error Msg 
Documentat ion 



Find caller of 
syserr 



Survey logs, 
prev. faults, etc. 



Execute Fault 



Execute Switches 



Examine 
8y8_trouble MCs 



Examine 
dunqt registers 



yes 



Get other info: logs 
prev. faults, AMs. . . 



Determine possible 
broken boxes. 



Correlate with info 
of earlier problems 



Get prgm listing, 
trace back to cause 



yes 



1 1 Hdw 

I |miscalc? 



FIX HARDWARE 



FIX SOFTWARE 
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apte. Incl .pll 



segment int >ldd> Include contents modified: 01/06/85 1422.2 

entry modified: 06/21/85 1919.6 



I* BEGIN INCLUDE FILE ... apte. incl. pll */ 

/* Modified 1984-11-11 by E. Swenson for IPC event channel 

del aptep pointer! 

dol 1 apte based (aptep) aligned, 
2 thread unaligned, 

3 fp bit (18), 

3 bp bit (18), 
2 flags unaligned, 

3 mbz bit (1), 

3 wakeup_waiting bit (1), 

3 stop_pending bit (1), 

3 pre-empted bit (1), 

3 t^roc bit (1), 

3 loaded bit (1), 

3 eligible bit (1), 

3 idle bit (1), 

3 interaction bit (1), 

3 pre_einpt_pending bit (1), 

3 default_procs_required bit (1), 

3 realtlme_burst bit (1), 

3 alwaya_loaded bit (1), 

3 dbr_loaded bit (1), 

3 belng_loaded bit (1), 

3 shared_stack_0 bit (1), 

3 page_vait_f lag bit (1), 

3 firatsw bit (1), 

3 state bit (18), 
2 page_faults fixed bin (35), 
2 processid bit (36), 

2 te fixed bin (35), 

2 ts fixed bin (35), 

2 ti fixed bin (35), 

2 timax fixed bin (35), 

2 ipo_po inters lunaligned, 

3 event_thread bit (18), 

3 pad3 bit (18), 
2 ipsjnessage bit (36), 
2 asteps unaligKied, 

3 pds bit (18), 

3 dseg bit (18), 

3 prds bit (18), 
2 savex7 bit (18) unaligned, 
2 termjprocessid bit (36), 



validation. */ 



f* APT entry declaration for an active (known) process */ 
f* List thread */ 
f* Forward pointer */ 
f* Backward pointer */ 
\* Flags and miscellaneous */ 
f* This bit must be sero (sentinel bit) */ 
f* ON if process has received wakeup */ 
\* ON if process has received stop connect */ 
\* ON If process is being pre-empted by get_processor */ 
ON if process is hardcore process */ 

ON if required per-process pages are in memory and wired */ 
r* ON if process is eligible */ 
'* ON if this is an idle process */ 

ON if process has interacted recently */ 
'* ON if process has received pre-empt connect */ 

ON if apte.procs_required is system default */ 

ON if next eligibility is realtime */ 

ON if process is not to be unloaded *l 
'* ON If DBR is loaded on some CPU */ 

ON if somebody loading this process */ 
'* ON if a shared stack_0 is assigned */ 
'* flag ON if waiting for page */ 
'* OFF vintil process is intialised */ 
'* execution state */ 

'* total page faults for the process */ 

'* bit 0-17; offset of ATPE */ 

'* bit 18-35: sequential number */ 

'* virtual time since eligibility award *l 

'* virtual time since scheduling */ 

* virtual time since interaction */ 

'* maximum value allowed for apte.ti */ 



/* relative pointer to ITT list */ 

/* IPS signals pending */ 
/* relative ASTE pointers */ 
/* PDS (per-process) */ 
/* DSEG (per-process) */ 
/* PRDS (per-processor) */ 

/* x7 at call to getwork (return point in pxss) */ 
/* process to send wakeup at temination */ 



*.* 
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2 lock_ld bit (36), f* File System vinqleu ID associated with process */ 

2 tline_used_cIock fixed bin (71), /* Total CPU time when process last lost CPU */ 



/*********( 



2 walt_event bit (36) aligned, 
2 wct_lndex bit (18) unaligned, 
2 £lags2 unaligned, 

3 prlorlty_schedullng bit (1), 

3 apeclal_wakeups bit (6), 

3 pad? bit (7), 

3 batch bit (1), 

3 pr_ta8 bit (3), 
2 state_,change_tlme fixed bin (71), 
2 alarm_event fixed bin (71), 
2 alarm_tlme_thread bit (18) unaligned, 
2 alarm_tlme bit (54) unaligned, 

/**«****/ 



/* Event ID process awaiting */ 
/* rel offset of WCIE */ 

/* ON If guaranteed eligibility */ 
/* Special wakeup channels */ 

/* ON If absentee */ 

/* CPU tag running or last run */ 

/* Time apte> state last changed */ 

/* wakeup event for alarm dock manager */ 

/* thread of processes with pending alarms */ 

/* wakeup time for alarm */ 



2 term^channel fixed bin (71), 

2 ws_slze fixed bin, 

2 temax fixed bin (35), 

2 deadline fixed bin (71), 

2 lock bit (18) unaligned, 

2 unusable bit (18) tinallgned, 

2 cpu_monltor fixed bin (35), 

2 paglng_meaaure fixed bin (71), 
2 acces8_authorlzatlon bit (72), 
2 dbr fixed bin (71), 



/* wakeup event for account overflow */ 
/* working set estimate for the process */ 
/* maximum eligibility slice (vcpu) */ 
/* time of next run */ 

/* 0 APTE locked, unlocked >> return point of last unlock */ 
/* locking routines destroy */ 

/* If not 0, send wakeup to term_processld when virtual cpu 

/* reaches this (units 1/1024 sec) */ 

/* cumulative memory units */ 

/* authorization of this process */ 

/* DBR value (constant since DSE6 entry-held) */ 



2 vlrtual_cpu_tlme fixed bin (71), 
2 lttes_8ent fixed bin (18), 
2 lttes_got fixed bin (18), 

/* Cells used to drive and Instrument finite- state m 
measurement. Maintained by meter_response_tlme */ 



/* cumulative virtual CPU time for the process */ 

/* Unprocessed ITTs sent by this process */ 

/* Unprocessed ITTs received by this process */ 

for response time 



2 current_responae_state fixed bin (17) unaligned, 

2 padlS bit (18) unaligned, 

2 nxunber^^procestslng fixed bin (35), 

2 last_respon8e_state_tlme fixed bin (71), 

2 total_processlng_tlme fixed bin (71), 



I* Process state In modle */ 

Number Interactions */ 
/* Clock time at last response state change */ 
/* Total Interaction processing time */ 



f* ***** *f 



2 begln_lnteractlon_vcpu fixed bin (71), /* Virtual cpu at beginning of last Interaction */ 

/* End of cells for finite-state model */ 



2 saved_tem8x fixed bin (35), 

2 procs_requlred bit (8) unaligned, 

2 pad4 bit (28) unaligned, 

2 lpc_r_offset fixed bin (18) unsigned, 

2 lpc_r_£actor fixed bin (35) unsigned. 



/* temax at eligibility award */ 

/* bit mask of CPUs this process can run */ 
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2 apad (10) fixed bin (35) t 
/* END INCLUDE FILE ... apte. incl .pLl */ 



apte . Incl. .pll Page 



aate. Incl.pll 



segment Int >Xdd>include contents modified: 01/30/85 1523.9 

entry modified: 06/21/85 1920.0 



/* BEGIN INCLUDE FILE .. .astc. Incl.pll . . . */ 

/* Template for an AST entry. Length - 12 words. */ 

/* Words 0 to 7, and 11 are read by PC| they are read and modified by SC. 

Words 8, 9 and 10 are modified by PCt they should never be modified without locking the PC lock */ 
/* Modified January 1985 by Keith Loepere for multl_elas8. */ 

del astep ptrt 

del 1 aste based (astep) aligned. 



(2 fp bit (18), 


/* 


forward used list rel pointer */ 


2 


bp bit (18), 


/* 


backward used list rel pointer */ 


2 


infl bit (18), 


/* 


ptr to NEXT In list of ASTE's of my brothers */ 


2 


infp bit (18), 


/* 


ptr to FIRST In list of ASTE's of my children */ 


2 


strp bit (18), 


/* 


rel pointer to process trailer */ 


2 


par_astep bit (18), 


/* 


rel pointer to parent aste */ 


2 


uld bit (36), 


/* 


segment unique id */ 


2 


msl bit (9), 


/* 


maximum segment length in 1024 word units */ 


2 


pvtx fixed biin (8), 


/* 


physical volume table index */ 


2 


vtocx fixed bin (17), 


/* 


vtoc entry index */ 


2 


usedf bit (1) , 


/* 


ast entry is being used if non-zero */ 


2 


Init bit (1), 


/* 


used bit - insure 1 lap */ 


2 


gtus bit (1), 


/* 


global transparent usage switch */ 


2 


gtma bit (1), 


/* 


global transparent modified switch */ 


2 


he bit (1), 


/* 


hard core segment */ 


2 


hc_sdw bit (1), 


/* 


aste with sdw for hardcore seg if non-zero */ 


2 


any_acces3_on bit (1), 


/* 


any sdw allows access, unless write_access_on */ 


2 


write_acces5_on bit (1), 


/* 


any sdw allows write access */ 


2 


inhibit_cache bit (1), 


1* 


flag not to reset above bits */ 


2 


explicit_deact_ok bit (1), 


1* 


set if user can deactivate seg */ 


2 


deact_error bit (1), 


f* 


set If error occurred while deactivating */ 


2 


hc_part bit (1), 


1* 


set If pages are in a hardcore partition */ 


2 


fin_d«unaged bil: (1), 


1* 


set if filemap checksum was ever bad */ 


2 


multl_class bit (1), 


/* 


set if page_control should watch state changes to this segment */ 


2 


padl bit (2), 


/* 


00 */ 


2 


diua bit (1), 


/* 


dumper In use switch */ 


2 


nid bit (1), 


/* 


if on prevents addtion to incremental dump map */ 


2 


dmpr_pad bit (1), 






2 


ehs bit (1), 


/* 


entry hold switch */ 


2 


nqsw bit (1), 


/* 


no quota switch - no checking for pages of this seg */ 


2 


dirsw bit (1)„ 


1* 


directory switch */ 


2 


master_dir bit (1), 


1* 


master dir - a root for the log volume */ 


2 


volmap_seg bit (1), 


1* 


volmap_seg for some volume */ 



*.* 
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2 tqsw (Oil) bit (1), 
2 pad_io bit (10), 

2 dtu bit (36), 

2 dtn bit (36), 



2 quota (0:1) fixed bin (18) unsigned, 

2 used (0:1) fixed bin (18) unsigned, 

2 csl bit (9), 

2 fmchanged bit (1), 

2 fms bit (1), 

2 npfs bit (1), 

2 gtpd bit (1), 

2 dnzp bit (1), 

2 perjproeesa bit (1), 

2 ddnp bit (1), 

2 pad2 bit (2), 

2 records bit (9), 

2 np bit (9), 



2 ht_fp bit (18), 

2 fmchangedl bit (1), 

2 damaged bit (1), 

2 pack_ovfl bit (1), 

2 synchronized bit (1), 

2 pad3 bit (6), 

2 ptsl bit (2). 

2 marker bit (6)) unaligned; 



del asta (0 : 8000) bit (36*12 /* sst-> sst.astsize */ 



del 1 aste_part aligned based (astep), 

2 one bit (36) unaligned, 

2 two bit (36*11 - 8) unaligned, 

2 three bit (8) unaligned i 



del 1 seg_aste based (astep) aligned, 
2 padl bit (8*36), 
:2 usage fixed bin (35), 
2 pad2 bit (3*36) J 

/* END INCLUDE FILE ... aste.lncl.pll */ 



/* terminal quota switch - (0) for non dir pages */ 
/* Used to bo aste.lc */ 

/* date and time segment last used */ 

/* date and time ae,gment last awdified */ 



/* sec storage quota - (0) for non dir pages */ 

/* see storage used - (0) for non dir pages */ 

/* current segment length in 1024 words units */ 
/* turned on by page if file map changed */ 
/* file modified switch */ 
/* no page fault switch */ 

/* global transparaint paging device switch */ 
/* don't null out if zero page switch */ 
/* use master quota for this entry */ 
/* don't deposit nulled pages */ 

/* number of records used by the seg in sec storage */ 
/* number of pages Ln core */ 

/* hash table forward rel pointer */ 

/* value of "fmchanged" saved by pc$get_f lle_map */ 

/* PC declared segment unusable */ 

/* page fault on seg would cause pack overflow */ 

/* Data Management synchronised segment */ 

/* 00(X)00000 */ 

/* page table size Index */ 

/* marker to indicate last word of ASTE */ 



based aligned i 



/* fp and bp */ 

/* part that has to be zeroed when ASTE is freed */ 
/* ptsl and marker */ 



/* Overlay because quota is only for dirs */ 
/* page fault count: overlays quota */ 



* . * 



aste.lncl.pll 
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bos_duinp. Incl .pll 



segment ins >ldd>include contents modified: 08/12/81 2025.8 

entry tnodtfled: 06/21/85 1915.4 



/* BEGIN INCLUDE FILE ... bo8_duiiip.inol.pll . . . */ 
/* Modified 1 September 1976 */ 

/* Modified 11/11/80 by J. A. Bush for the DFS8/70M CPU */ 

/* Modified 6/12/81 by Rich Coppola to extend the dpsS extended fault reg to 
15 bits */ 

/* Modified 02/23/81, W. Olin Sibert, to describe old and new FOUMP styles */ 



del dumpptr ptri 

del 1 dump baaed (dvunpptr) aligned, 

2 durop_header aligned like dump^header, 

2 sega (1008), 

3 aegno bit (18) xinal, 
3 length bit (18) unal, 

2 aroptwregs (0 t 63) bit (36), 

2 amptwptrs (0 t 63) bit (36), 

2 amsdwregs (0 t 63) bit (72), 

2 amadwptrs (0 t 63) bit (36), 

2 ouhlat (0 : 63) bit (72), 

2 cuhlst (0 : 63) bit (72), 

2 duhlat (0 i 63) bit (72), 

2 auhlat (0 : 63) bit (72), 

2 prs (0 : 7) ptr, 

2 regs aligned like dufflp_regl8ters, 

2 low_orderjport bit (3), 
2 padA bit (36), 
2 mctlme fixed bin (52), 
2 pads (0 t 3) bit (36), 

2 mise_registers like dump_miso_registers, 

2 ptrlen (0 i 7) bit (36), 

2 coreblocks (0 : 7), 

3 n\iro_flrat bit (18) unal, 

3 num_blocka bit (18) unal, 
2 pad7 Tll2) fixed blm 



/* pointer to following structure */ 
/* header of dump by fdump */ 

/* segment array */ 
/* segment number */ 

/* length of segment in sector sised blocks */ 

/* assoc. mem. page table word regs */ 

/* asaoc. mem. page table word pointers */ 

/* assoc. offim. segment descriptor word registers */ 

/* assoc. mem. segment descriptor word pointers */ 

/* operations unit hlatory registers */ 
/* control unit hlatory registers */ 
/* decimal unit history registers */ 
/* appending unit history registers */ 

/* pointer registers *l 

I* asaorted machine registers */ 

/* from which clock la read */ 

/* tioie conditions were taken */ 

/* Assorted registers & processor data */ 
/* pointers and lengths for EIS */ 



/* first addr in coreblock */ 
/* nvmiber of blocks used */ 



del 1 dufflp_header aligned based, /* Standard header for FDUMP */ 

2 words_dumped fixed bin (35), /* total words in dump */ 

2 valid bit (1), /* - 1 if there is a 6180 dump to be had */ 

2 time fixed bin (71), /* time of dump */ 



*.* 
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2 exfno fixed bin (18), 

2 num_segs fixed bin« 

2 valid_355 bit (1), 

2 duinped_355s bit (4), 

2 tiine_355 fixed bin (71), 

2 version fixed bin, 

2 padO (5) fixed bini 

del I duinp_registeES aligned based, 
(2 X (0 : 7) bit (18), 
2 a bit (36), 
2 q bit (36), 
2 e bit (8), 
2 pad2 bit (28), 
2 t bit (27), 
2 pad3 bit (6), 
2 ralr bit (3)) unaligned! 

del 1 duinp_mi8c_registar8 aligned based, 
2 scu To t 7} bit (36), 
2 mem (0 s 7) bit (72), 
2 dbr bit (72), 
2 intrpts bit (36), 
2 bar bit (36), 
2 modereg bit (36), 
2 cmodereg bit (36), 
2 faultreg bit (36), 
2 ext_fault_reg bit (15) unaligned, 
2 pad6 bit (21) unaligned i 



del 1 vl_duiiip aligned based (dumpptr), 

2 dump_header aligned like duinp_headex, 

2 s«gs (688), 

3 segno bit (18) unal, 
3 length bit (18) unal, 

2 aaiadwregs (0 i 15) bit (72), 
2 anisdwptrs (0 : 15) bit (36), 
2 aniptvregs (0 t 15) bit (36), 
2 araptwptxs (0 s 15) bit (36), 
2 padl (0 : 15) bit (36), 

2 oiihist (0 s 15) bit (72), 

2 ciihist (0 : 15) bit (72), 

2 axihiat (0 : 15) bit (72), 

2 duhist (0 : 15) bit (72), 

2 pra (0 : 7) ptr, 

2 r«gs aligned like dufnp_Eeglatexs, 



2 tnctlme fixed bin (52), 
2 pad4 (0 s 5) bit (36), 



/* Error Report Form Number */ 
/* number o£ segments dvimped */ 
/* 1 if there is a dn355 dump to be had */ 
I* indicates which 355s were dumped */ 
/* time of 355 dua^ */ 
/* currently 2 */ 
/* padO to 16 words */ 

/* Standard (SRE6) arrangement of registers in dump */ 

/* index registers */ 

/* the a register */ 

/* the q register */ 

/* the c register */ 

/* pad */ 

/* timer register */ 
/* pad */ 

/* ring alarm register */ 



'* from store control unit instr. */ 

'* memory controller masks every 64 K */ 

'* descriptor segment base register */ 

'* interrupts */ 

'* base address register */ 

'* mode register */ 

'* cache mode register */ 

'* fault register */ 

* DFS8 extended fault register */ 



/* Old version of FDUMP (pre March, 1981) */ 



/* segment array */ 
/* segment number */ 

/* length of segment in sector sized blocks */ 

/* assoc. mem. segment descriptor word registers */ 
/* assoc. mem. segment descriptor word pointers */ 
/* assoc. mem. page table word rega *l 
I* assoc. mem. page table word pointers */ 



/* operations unit history registers */ 
/* control unit history registers */ 
/* appending unit history registers */ 
/* decimal vinit history registers */ 

/* pointer registers */ 

/* assorted machine registers */ 

/* time conditions were taken */ 



dump . Incl "1 "L 
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2 inlsc_regLstei;s aligned like duiDp_iDisc_reglsters , /* Assorted registers */ 



2 pads bit (36), 

2 ptrlen (0 : 7) bit (36), 

2 pad6 (15) bit (36), 

2 low_order_port bit (3), 

2 coreblocks (0 t 7), 

3 num_fir8t bit (18) unal, 
3 nuffl_blocks bit (18) tinali 



/* pointers and lengths for EIS */ 
/* from vfaich cLook was read */ 

/* first addr in corebLook */ 
/* number of blocks used */ 



del DUMP_VERSZ0N_1 fixed bin internal static options (constant) init (1)| 
del DUMP_VERSI0N_2 fixed bin internal static options (constant) init (2)t 

/* END INCLUDE FILE ... bos_dump.incl.pll . . . */ 



bos_dtiinp . incl . pll Page 



cmp. .incl.pll 



segment ins >Ldd>inclu<le contents modified: 11/23/82 0953.7 

entry modified: 06/21/85 1917.1 



/* BB6ZN INCLUDE FILE cmp. incl.pll October 1982 */ 

/* Note: This include file has an ALM counterpart NOT i 

del cmep ptrt 

del 1 cme based (cmep) aligned, 
2 fp bit (18) unaligned, 
2 bp bit (18) unaligned, 

2 devadd bit (22) unaligned, 

.'2 pads bit (1) unaligned, 

2 synch_heLd bit (1) unaligned, 

2 io bit (1) unaligned. 

2 pad2 bit (1) unaligned, 

2 er bit (1) unaligned, 

2 removing bit (1) unaligned, 

2 abs_w bit (1) unaligned, 

2 abs_usabla bit (1) unaligned, 

2 notify_requeated bit (1) unaligned, 

2 pad3 bit (1) tinallgned, 

2 phm_hedge bit (1) unaligned, 

2 contr bit (3) unaligned, 

2 ptwp bit (18) unaligned, 

2 aatep bit (18) unaligned, 

2 pln_counter fixed bin (17) unaligned, 

2 synch_page_entryp bit (18) unalignedi 



del 1 ema (0: 1) based aligned like cmei 

del 1 mcme based (cmep) aligned, 
2 pad bit (36) unaligned, 
2 record_no bit (18) unaligned, 
2 add_type bit (4) unaligned, 
2 flags bit (14) unal, 
2 padl bit (18) unalt 



/* END INCLUDE FILE cmp. incl.pll */ 



with oif (for historical reasons). Keep it up to date *l 

I* pointer to core map entry */ 

/* core map entry */ 

/* forward pointer to next entry */ 

/* backward pointer to previous entry */ 

/* device address of page in the core block */ 

/* Page of synchronised seg held in memory */ 
/* input/output indicator l^output, 0«input */ 

/* indicates error in previous 10 activity */ 

/* core is being removed by reconfiguration */ 

/* absolute address must not be changed for page */ 

/* page may be assigned with fixed absolute address */ 

/* notify requested on I/O completion */ 

/* on pc$flush_eore ought write. */ 

/* controller in which core block is located */ 

/* pointer to page table word for the page */ 
/* relative AST entry pointer of page */ 
/* number of times to skip eviction */ 
/* relp to synch page entry *l 



I* Core map array */ 

/* core map entry for extracting DID */ 

/* record nvunber of device *l 
I* see add_type. incl.pll */ 



*.* 



cmp. incl .pll 
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dlr_acl . IncL .pll 



segment in: >ldd> include contents modified: OA/29/76 1048.9 

entry modified: 06/21/85 1913.7 



/* BEGIN INCLUDE FILE ... dir_acL.incl.pll ... last 

/* Template for an ACL entry. Length - 8 words */ 
del adep ptrt 

del 1 acl_entry based (adep) aligned, 
2 frp bit(18) unaligned, 
2 brp bit(18) unaligned, 

2 type bit (18) unaligned, 

2 size fixed bin (17) unaligned. 



2 name unaligned, 

3 pera_rp bit(18) unaligned, 

3 proj_rp bit (18) unaligned, 

3 tag char(l) imaligned, 
2 mode bit (3) unaligned, 
2 pad24 bit (24) unaligned, 

2 ex_mode bit (36), 

2 checksvim bit (36), 
2 owner bit (36) i 

t* Teiiq>lats for a person or project name on ACL. Length 

del 1 access_name aligned based, 
2 frp bit (18) uiaaligned, 
2 brp bit(18) unaligned, 

2 type bit (18) unaligned, 

2 size fixed bin (17) unaligned, 

2 salv_flag fixed bin(17) unaligned, 
2 usage fixed bin(17) unaligned, 

2 padl bit (36), 

2 name char (32) aligned, 

2 checksum bit (36), 

2 owner bit (36) i 

/* END INCLUDE FILE ... dir_acl.incl.pll */ 



modified Nov 1975 for nss */ 



/* length is 8 words */ 

/* rel ptr to next entry */ 

/* rel ptr to previous entry */ 

/* type - dir aol */ 
/* sise of acL entry */ 



/* user name associated with this ACL entry */ 

/* name of user */ 

/* project of user */ 

/* tag of user */ 

/* mode for userid */ 



/* extended access modes */ 

/* checksum from acl_entry.name */ 
/* uid of owning entry */ 

" 14 words. */ 

/* person or project name */ 

/* rel ptr to next name structure */ 

/* rel ptr to prev name structure */ 

/* type - access name */ 
/* size of access name */ 

/* used by salvager to cheek for aseii names */ 

/* number of ACL entries that refer to this name */ 



/* person or project name itself */ 

/* checksum from salv_flag */ 

/* uid of containing directory */ 



dir_acl . incl .pll 
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dlr_»l Locat lon_are« . Incl . pi 1 



sagment Ini >l<ld>includa contants modifiadt 10/15/76 1242.9 

entry modified: 06/21/8S 1913.7 



/* BEGIN INCLUDE FILE ... dlr_allooatlon_«re8. Incl.pll ... last modified December 1973 */ 
del araap ptri 

del 1 area based (axeap) aligned, 
2 nalzes fixed bin (18), 
2 lu fixed bin (18), 
2 Iw fixed bin (18), 
2 array (100) aligned, 

3 fptr bit (18) unaligned, 

3 alse fixed bin (17) unallgnedi 

/* END INCLUDE FILE ... dlr_allooatlon_area.lnol.pll */ 
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/* Number of tsrpea. */ 
/* Next available word In area. */ 
/* Last usable word. */ 
/* Array of types. */ 
/* Free pointer for this else. */ 
/* Slse. */ 



dlr_entry . incL .pll 



segment Int >ldd>lnolud« contentj modified: 04/29/76 1100.6 

entry modlficdi 06/21/85 1913.7 



/* 



BEGIN INCLUDE FILE ... dlx_entxy.lncL.pIl ...laat modified August 1974 fox nss */ 



/* Template fox an entry. Length ■ 38 woxds */ 
del ep ptrt 

del 1 entry based (ep) aligned, 

(2 efxp bit (18), 

2 ebrp bit (18)) unaligned, 

2 type bit (18) unaligned, 

2 size fixed bin (17) luialigned, 

2 uid bit (36), 

2 dtem bit (36), 

(2 bs bit (1), 

2 padO bit (17), 

2 nnsmes fixed bin (17), 

2 name_fcp bit (18), 
2 name_brp bit (18), 

2 author, 

3 pers_rp bit (18), 
3 proJ_rp bit (18), 

3 tag char ( 1 ) , 
3 padl char (3), 

2 prlmary_name bit (504), 

2 dtd bit (36), 

2 pad2 bit (36), 



* forwai»d xeL ptx to next entxy */ 

* backwaxd xel ptx to previous entxy */ 

* type of object " dir entxy */ 

* size of dix entry */ 

* unique id of entry */ 

* date-time entry modified */ 

* branch switch >■ 1 if branch */ 

* number of names for this entry *t 

* rel pointer to start of name list */ 

* rel pointer to end of name list */ 

* user who created branch */ 

* name of user vho created branch */ 

* project of user who created branch */ 

* tag of mex who exeated bxanch */ 

* first nanie on name list */ 

* date time dumped */ 



/* the declaxations below axe fox bxanch only */ 



2 pvid bit (36), 

2 vtocx fixed bin (17), 
2 pad3 bit (18), 

2 dirsw bit (1), 
2 oosw bit (1), 



/* physical volume Id */ 
/* vtoc entry index */ 



/* <■ 1 if this is a directory branch */ 
/* out of service switch on 1 */ 



dlr_entry . Incl .pll 
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2 per_j>rooess_sw bit (1), 
2 copysw bit (1), 
2 sa£ety_sw bit (1), 
2 iiiultLple_cl«S9 bit (1), 
2 audLt_£lag bit (1), 
2 securLt}r_oosw bit (1), 
2 en,txypt_sv bit (1), 
2 inaster_dix bit (1), 
2 tpd bit (1), 
2 pad4 bit (11), 

2 entrypt_bound bit (14) ) unaligned, 

2 acc«88_clas8 bit (72) alignad, 

(2 ring_brackets (3) bit (3), 
2 •x_ring_brackats (3) bit (3), 
2 acl«_coiint fixed bin (17), 

2 acl_£xp bit (18), 
2 acl'biV bit (18), 

2 bc_author, 

3 pers_rp bit (18), 
3 P^oi_vp bit (18), 

3 tag char (1), 
3 pads bit (2), 
2 be fixed bin (24)) unaligned, 

2 8ons_lvid bit (36), 

2 pad6 bit (36), 

2 checksum bit (36), 

2 owner bit (36) i 

/* END INCLUDE FILE ... dir_entry. inci .pll . . . */ 



/* indicates segment is per process */ 
/* 1 make copy of segment whenever initiated */ 
/* if 1 then entry cannot be deleted */ 
/* segment has nniltLple security classes */ 
/* segment must be audited for security */ 
/* security out of jervice switch */ 
/* 1 if call liffliter is to be enabled */ 
/* TRUE for master directory */ 

/* TRUE if this segment is never to go on the PO */ 
/* call lifflitar */ 

/* security attributes t level and category */ 

/* ring brackets on segment */ 
/* extended ring brackets */ 
/* number of entries on ACL */ 

/* rsl ptr to start of ACL */ 
/* rel ptr to end of ACL */ 

/* user vho last set the bit count */ 
/* name of user who set the bit count */ 
/* project of user who set the bit count */ 

/* tag of user vbo set the bit count */ 

/* bit count for segs, msf indicator for dirs */ 

/* logical volume id for immediat inf non dir seg */ 



/* checksum from dtd */ 

/* uid of containing directory */ 



dLr_entry . Incl .pll 
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dlr_header . Incl . pi J 



segment In: >ldd>include contents modified: 05/24/82 lOOS.O 

entry modified: 06/21/85 1916.7 



/* BEGIN INCLUDE FILE ... dir_header.incl.pll */ 

/* Modified 8/74 for NSS */ 

/* Modified 8/76 to add version number and hash table rel pointer for variable hash table sizes */ 
/* Modified 3/82 BIM for change pclock */ 
/* format: style3 */ 

/* Template for the directory header. Length " 64 words. */ 
del dp ptri 

del 1 dir based (dp) aligned, 



2 modify bit (36), 
2 type bit (18) unaligned, 
2 size fixed bin (17) unaligned, 
2 dtc (3), 

3 date bit (36), 

3 error bit (36), 

2 uld bit (36), 

2 pvid bit (36), 

2 sons_lvld bit (36), 

2 acce98_class bit (72), 

(2 vtocx fixed bin (17), 

2 version number fixed bin (17), 



2 8eg_count fixed bin (17), 
2 dir_count fixed bin (17), 

2 Icount fixed bin (17), 

2 acle_total fixed bin (17), 

2 arearp bit (IH), 

2 per_process_3w bit (1), 



/* Process ID of last modifier */ 
/* type of object « dir header */ 

f* sise of header in words *l 
f* date-time checked by salvager array */ 
f* the date */ 

I* what errors were discovered */ 



2 entryfrp bit (18), 


/* 


rel ptr to 


2 pad2 bit (18), 






2 entrybrp bit (18), 


/* 


rel ptr to 


2 pad3 bit (18), 






2 pers_frp bit (18), 


/* 


rel ptr to 


2 proj"frp bit (18), 


/* 


rel ptr to 


2 pers_brp bit (18), 


/* 


rel ptr to 


2 proJ_brp bit (18), 


/* 


rel ptr to 



* uld of the directory 

* phys vol id of the dir 

* log vol id for inf non dir seg 

* security attributes of dir 

* vtoc entry index of the dir 

* version nvimber of header */ 



copied from branch */ 
copied from branch */ 
copied from branch */ 
copied from branch */ 
copied from branch */ 



* number of non-directory branches */ 

* niunber of directory branches */ 

* nvimber of links */ 

* total number of ACL entries in directory */ 

* relative pointer to beginning of allocation area */ 

* indicates dir contains per process segments */ 
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2 ma.ster_dlr bit (1), 
,2 foroe_rpv bit (1), 
2 rehashing bit (1), 
2 pad4 bit (14), 

2 laol_coimt (0:7), 
3 aeg fixed bin (17), 
3 dlr fixed bin (17), 

2 Ucl (0s7), 

3 seg_fxp bit (18), 
3 eeg.brp bit (18), 

3 dlr_frp bit (18), 
3 dlr_brp bit (18), 

2 htfllze fixed bin (17), 
2 hash_table_rp bit (18), 

2 htused fixed bin (17), 
2 pad6 fixed bin (17), 

2 tree_depth fixed bin (17), 
2 pad7~blt (18)) unaligned, 

2 dts bit (36), 

2 master_dlr_uld bit (36), 

2 changejpcLook fixed bin (35), 

2 pads (11) bit (36), 

2 checksum bit (36), 

2 owner bit (36) i 

del verslon_number_2 fixed bin Int static 

/* END INCLUDE FILE ... dlr header. 



/* TRUE If this Is a master dlr */ 
/* TRUE If segs must be on RPV */ 
/* TRUE If hash table Is being constructed */ 



/* number of Initial ael entries for segs */ 
/* number of Initial acl entries for dlr */ 

/* pointer to Initial ACLs for each ring */ 
/* rel ptr to start of Initial ACL for segs */ 
/* rel ptr to end of Initial ACL for segs */ 

/* rel ptr to start of Initial for dlrs */ 
/* rel ptr to end of Initial ACL for dlrs */ 

/* slse of hash table */ 

/* rel ptr to start of hash table */ 

/* no. of used places In hash table */ 



/* number of levels from root of this dlr */ 



/* date-time directory last salvaged */ 

/* uld of superior master dlr */ 
/* up one each call to sum$dlrmod */ 
/* pad to make It a 64 word header */ 
/* checksummed from uld on */ 
/* uld of parent dlr */ 



options (constant) Inlt (2)t 
Incl.pll */ 
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dtr_ht.incl.pll 



■•gimnt Ini >ldd>inolud« eontenta iiiodLfLedi 11/02/76 1414.6 

entry modified t 06/21/85 1913.7 



/* BEGIN INCLUDE FILE ... dir_ht.inel.pll */ 



dol htp ptri 

del 1 hash_table baaed (htp) aligned, 
2 modify bit (36) unal, 
2 type bit (18) unal, 
2 size fixed bin (17) unal, 
2 name_rp (0:1) bit(18) vinal, 
2 checksum bit (36) unal, 
2 owner bit (36) unali 



/* END INCLUDE FILE ... dir_ht.inel.pll */ 



/* htp ■* ptr(dp,aetive_hardcor«_data$htrp) */ 

/* type - dir hash table */ 

/* size of current dir hash table entry */ 

/* rel ptr of name entry */ 



/* otherwise rel ptr to name */ 



dir_ht . incl .pll 
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dlr link.lncl.pll segment int >ldd>lnclude eontente modlfLedi 04/29/76 1049.2 

entry modified: 06/21/85 w1913.7 

/* BEGIN INCLUDE FILE ... dir_link.lncl.pll ... Iftst modified August 1974 for nss */ 
/* Template for link. Note that it is identical to entry for first 24 words. */ 

del 1 link based (ep) aligned, 



(2 efrp bit (18), 


/* 


forward rel ptr to next entry */ 


2 ebrp bit (18), 


/* 


backward rel ptr to previous entry */ 


2 type bit (18), 


/* 


type ■ dlr link *l 


2 size fixed bin (17), 


1* 


sice of link in words */ 


2 uid bit (36), 


1* 


unique id of entry */ 


2 dtero bit (36), 


1* 


date-time entry raodified */ 


2 bs bit (1), 


1* 


entry switch > 1 if entry */ 


2 padO bit (17), 






2 nnames fixed bin (17), 


1* 


number of names for this entry */ 


2 name_frp bit (18), 


1* 


rel pointer to start of name list */ 


2 name_brp bit (18), 


1* 


rel pointer to end of name list */ 


2 author, 


1* 


user who created entry */ 


3 pers_rp bit (18), 


1* 


name of user who created entry */ 


3 proJ_rp bit (18), 


1* 


project of user who created entry */ 


3 tag char (1), 


1* 


tag of user who created entry */ 


3 padl char (3), 






2 primary_name bit (504), 


1* 


first name on name list */ 


2 dtd bit (36), 


1* 


date time dumped */ 


2 pad2 bit (36), 







/* the declarations below are only applicable to links */ 
2 pad3 bit (18), 

2 pathname_size fixed bin (17), /* number of characters in pathname */ 

2 pathname char (168 refer (pathname_8lze))) unaligned, /* pathname of link */ 
2 checksum bit (36), /* checksum from uid */ 

2 owner bit (36) t /* uid of containing directory */ 

/* END INCLUDE FILE ... dir_link. Incl.pll */ 
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dlr_lQck seg .Incl.pll segment Ins >ldd>lncLudc contents modified: 11/29/83 0931.2 

entry modified! 06/21/85 1918.7 



/* Begin include file dir_lock_seg_. incl.pll BIM 830312 */ 
/* From dirlockt. incl.pll */ 

/* formats styles , idind25 , indcomtxt */ 

/**** Several arrays in this program are zero based. The xero-th 

entries are NEVER USED, referencers should start at 1, not Ibound. 
The zero entries are there to improve the eonqpiler'a subscript 
calculations. The compiler can fetch dir_lock_all_di.r_,lock8 (foo).uid 
with an Ida pr6|F00,*ql */ 



del 
del 
del 

declare 



dir_lock_seg$ 

dir_lock_segp 

1 dlr_lock_seg 
2 header 
2 dir_locks 
2 readers 



external static < 



pointer! 



/* name of the segment containing the directory locks */ 
/* pointer to the dirlook table */ 



baaed (dir_lock_segp) aligned, 
aligned like dir_lock_seg_header, 

(O:dir_lock_seg.header.n_,dir_locks) aligned like dir_lock« 

(Otdir_lock_seg.header.n_dir_locks, dir_lock_seg. header. max_readers) bit (36) aligned a 



(dir__look_all_locksp , dir_look_all_readersp) 
pointer! 



declare 1 dir_lock_all_dir_locks (O:dir_lock_seg. header. n_dir_locks} aligned like dir_lock based (dir_lock_all_locksp) i 
declare dir_lock_all_readers (0 :dir_lock_seg.header. n_dir_Iocks p dir_lock_aeg. header. max_readers) bit (36) 

aligned based (dir_lock_alI_treadersp} i 



declare 
declare 



DIR LOCK SEG EVENT 



char (4) aligned init ("drls") int static options (constant) t 



1 dir_lock_aeg_header aligned based, 



2 seg_Iock 
2 n_dlr_locks 
2 highe»t_ln_use 
2 max_readers 
2 pad_even 
2 readersjptr 
2 locks,_ptr 
2 metera 

3 find_calla 
3 flnd_f allures 
3 max__in_use 
3 padjneters 
2 pad 



aligned like lock, 

fixed bin, 

fixed bin, 

fixed bin, 

bit (36) aligned, 

pointer, 

pointer, 

aligned, 

fixed bin (35), 

fixed bin (35), 

fixed bin (35), 

fixed bin (35), 

(16) bit (36) alignedi 



/* max number */ 



/* to 32 */ 



declare dir_lockp 
declare 1 dir_lock 
2 uid 
2 flags 

3 notify_sw 
3 salvage_sw 



pointer I 

aligned based (dir_lockp), 
bit (36) aligned, 
aligned, 

bit (1) unaligned, 
bit (1) unaligned. 



/* ON if dir was locked for salvage */ 



dir_lock__seg_. incl .pll 
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3 pad 
2 lock count 



2 write Locker 



bit (34) unaligned, 
fixed bin (17), 



bit (36) alignedi 



/* POSITIVE — > wrlte^lock */ 

/* NEGATIVE ~> -number of lockers */ 

/* ZERO — > not locked */ 

/* in case of read, see next declaration, and expect this 0 */ 



declare 
declare 



dir_read_lockers_ptr 
dir read lockers 



pointers 

(dir_lock_seg. header. iiiax_readers) bit (36) aligned based (dir_read_lockers_ptr) i 



/* End include file dir_lock_seg_.incl.pll */ 
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dir_name . Incl .pLl 



segment In: >ldd>lnclude contents modified: 11/02/76 1414.7 

entry modified: 06/21/85 1913.7 



/* BEGIN INCLUDE FILE ... dlr_neffie.lncl.pll ... last modified Nov 1975 for nss */ 
/* Template for names of branches or links. Length " 14 words. */ 
del np ptri 



1 


names based aligned » 


/* 


based on ptr(dp,ep'*^entry.name frp) 


2 


fp blt(18) unaligned, 


/* 


rel ptr to next name */ 


2 


bp bit (18) tuallgned, 


/* 


rel ptr to prev name */ 


2 


type bit (18) unaligned, 


/* 


type <■ dlr name */ 


2 


else fixed bin (17) unaligned, 


/* 


size of dlr name */ 


2 


entry_rp bit (18) unaligned, 


/* 


rel ptr to entry */ 


2 


ht_lndex fixed bln(17) unaligned. 


/* 


Index of hash table entry */ 


2 


ha9h_thread bit (18) unal. 


/* 


relative ptr to next hash entry */ 


2 


pad3 bit (18) unal, 






2 


name char (32) aligned. 






2 


checksum bit (36), 


/* 


checksum from entry_rp */ 


2 


owner bit (36) t 


/* 


uld of entry */ 



/* END INCLUDE FILE ... dir_name.lncl.pll */ 
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fault wctor. Inel .pLl 



segment Lni >ldd>LncIvtde contents modified: 06/22/81 1815.3 

entry modified: 06/21/85 1915.3 



/* BEGIH INCLUDE FILE ... f«ult_vectoc.inci.pIl ... last modified February 1981 */ 



fvi» ptrj 






/* 


pointer to the fault and interrupt vectors */ 




1 fv based (fvp) 


aligned, 


/* 


fault and intercvqjit vectors */ 




2 ipalr (0: 31), 






/* 
r 


interrupt pairs ^ / 




3 scu bit (36), 






/* 
# 


SCU instruction ^1 




3 tra bit (36), 






/* 


TRA instruction */ 




2 fpair (Oi 31), 






1* 


fault pairs */ 




3 sou bit (36), 






1* 

1 


scu Inafcrnet^lon 111 

9 WW &UB«.£Uwl.*WU 




3 tra bit (36), 






/* 
# 






2 i__tra_ptr (0: 31) ptr 




1 


TTfi nalip fair IntAinrunfe TRA Inatfuotion ^/ 




2 i_scu_j>tr (0: 31) ptr 




/* 
r 


ITS pair for interrupt SCU instruction */ 




2 f _tra_ptr (Oi 31) ptr 


t 


# 


TTfi fnr* "pAiilf^ TRA i.nAfcma1^i.Ofi ^/ 




2 f_8cu_ptr (Oi 31) ptri 


/* 
# 


ITS pairs for fault SCU instruction */ 




Fault Types by fault number 






*/ 


del (FAULT_NO_SDF 


init 


(0), 


/* 




*/ 


FA0LT~H0lsTR 


init 


(1), 


1* 






FAULT_H0J1ME 


init 


C2), 


1* 




*/ 


FAULT_N0~F1 


init 


(3), 


1* 


Vaul^ Tflir 1 


*/ 


FAOLT~HO~TRO 


init 


[4), 


1* 


Timer Runout 


*/ 


FAULT_MO~CMD 


init 


C5), 


I* 


WUIlWlflU&U 


*/ 


FAULT_HO_DItt. 


init 


C6), 


I* 


T\ArA 1 1 


*/ 


FAULT_NO~LUF 


init 


[7), 


1* 


T n^lrim 


*/ 


faoltIhoIcoh 


init 


[8), 


1* 




*/ 


faolt_noIpar 


init 


[9), 


1* 


Parity 


«/ 


FAULT_HO~IPR 


init 


[10), 


1* 


Til AOJlI Pl*af*Allt1T*A 


*/ 


FAULT~HO~OHC 


init 


(11), 


1* 


Operation Not Complete 


*/ 


FAULT~HO~SW 


init 


:i2>. 


/* 




*/ 


FAULT_NO~OFL 


init 


'13), 


/* 




*/ 


FAULT_NO_DIV 


init 


:i4). 


/* 


Divide Check 


*/ 


FAULT_NO_EXF 


init 


15), 


/* 


Execute 


*/ 


FAULT~NO~DF0 


init 


'16), 


/* 


Directed Fault Cl (Segment Fault) 


*/ 


FAULT_N0_DF1 


init 


17). 


/* 


Directed Fault 1 (Page Fault) 


*/ 


FAULT_N0_DF2 


init ( 


18), 


/* 


Directed Fault 2 


*/ 


FAULT_N0_DF3 


init 


19). 


/* 


Directed Fault 2) 


*/ 


faultIno_acv 


init 


20), 


1* 


Access Violation 


*/ 


FAULT_N0_MME2 


init 


21), 


1* 


Master Mode Enti;y 2 


*/ 


FAULT_K0~MKE3 


init ( 


22), 


1* 


Master Mode Entry 3 


*/ 


FAULT~N0_MME4 


init ( 


23), 


1* 


Master Mode Entry 4 


*/ 


FAULT"nO_F2 


Init ( 


2A), 


1* 


Fault Tag 2 (Linkage Fault) 


*/ 


FAULT_N0_F3 


init ( 


25), 


1* 


Fault Tag 3 


*/ 








1* 


Fault Numbers 26-30 unassigned 


*/ 


fault_no_trb 


init (31) 


1* 


Trouble 


*/ 



) fixed bin (17) int static options (constant)! 



*.* 
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/* END INCLUDE FILE ... fauIt_v«ctor. Incl.pll */ 
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fgbx.LncI.pll 



segment ini >ldd>incLude contents modified: 02/20/85 1000.3 

entry modified: 06/21/85 1920.1 



/* BEGIN INCLUDE FILE ... fgbx. inci .pll */ 

/* last modified 5/3/77 by Noel I. Morris */ 

/* Modified 8/79 by R.J.C. Kissel to add FNP blast message. */ 

/* Modified 7/82 BIM for recognizable sentinel field */ 

/* NOTE: THIS INCLUDE FILE DESCRIBES THE FIJkGBOX WITHIN THE BOS TOEHOLD, WHICH 
HAS HO VALUE WHATSOEVER. THE REAL MULTICS/BCE TOEHOLD FLAGBOX IS DESCRIBED BY 
THE FLAGBOX INCLUDE FILE. */ 

/* The contents of this segment are data shared by Hultics and BOS. 

This segment occupies the 2nd, 3rd, 4th, and 5th 16-word blocks of the BOS toehold. */ 



del flagbox$ exti 
del fgbxp ptri 

del 1 fgbx based (fgbxp) aligned, 
2 flags (36) bit (1) unal, 
2 slt_segno bit (18), 
2 padl fixed bin, 
2 rtb, 
(3 ssenb bit (1), 

3 call_bos bit (1), 

3 shut bit (1), 

3 mess bit (1), 

3 alert bit (1). 

3 pad bit (25), 

3 bos_entry fixed bin (5)) unal, 



2 sentinel char (32) aligned, 
2 satsdw bit (72), 
2 hc_dbr bit (72), 
2 message char (64), 
2 fnp_blast char (128); 



/* comnunieations switches */ 
/* segment # of the 8LT */ 

/* return to BOS info */ 
/* "i"b if storage system enabled */ 
/* "l"b if BOS called by operator */ 
/* "l"b if BOS called after shutdown */ 
I* "i"b if message has been provided */ 
/* "I'b if audible alarm to be sounded */ 

/* type of entry into BOS 

0 -> XED 10002 (BOS entry) 

1 -> XED 10004 (Multics entry) 

2 -> XED 10000 (manual entry) */ 
/* set by BOS (for now) */ 

/* set by lnlt_sst */ 

/* set by start_cpu, Idle DBR */ 

/* message for return to BOS */ 

/* message for FNP use when Multics is down. 



*/ 



declare FLAGBOX_SENTINEL char (32) init ("Flagbox k Toehold Valid") int static options (constant) i 



END INCLUDE FILE ... fgbx. incl .pll */ 



*•* 



fgbx. incl. pll 



Page 23 



f s_vol_l«b«l . Inol .pll 



segment int >lldd>include contents modlfleds 10/04/83 1105.1 

entry modifiedt 06/21/85 1917.9 



/* BEGIN INCLUDE FILE ... fs_voL_label. inol. pll .. last modiLfled January 1982 for new volume map format */ 
/* This is the label at fixed Location of each physical voliuie. Length 1 page */ 
/* Notet fsout_voI dears pad fields before writing the label */ 

del labelp ptri 

del 1 label based (labelp) aligned, 

/* First comes data not used by Hultics.. for conipatibility with 6C0S */ 

2 goes (5*64) fixed bin, 
/* Now we have the Multies label */ 



2 Multies ehar (32) init ("Multies Storage System Volumfli") 


, /* Identifier */ 


2 version fixed bin, 


/* 


Version 1 */ 


2 rofg_serial char (32), 


/* 


Manufacturer's serial number */ 


2 pv_name char (32), 


1* 


Physical volume name. */ 


2 lv_name char (32), 


1* 


Name of logical volume for pack */ 


2 pvld bit (36), 


1* 


Unique ID of this pack */ 


2 Ivld bit (36), 


/* 


unique ID of its logical vol */ 


2 rootjpvld bit (36), 


1* 


unique ID of the pack containing the root, everybody must agree. */ 


2 tlme_regl8ter>ed fixed bin (71), 


1* 


time imported to system */ 


2 n_pv_ln_lv fixed bin, - 


/* 


# phys volumes In logical */ 


2 vol_slze fixed bin, 


1* 


total size of volume, in records *l 


2 vtoc_sLze fixed bin, 


1* 


number of recs In fixed area ■(- vtoe */ 


2 not_used bit (1) unal. 


I* 


used to be multlple_class */ 


2 private bit (1) unal, 


I* 


TRUE if was registered as private */ 


2 flagpad bit (34) unal. 






2 max_access_class bit (72), 


1* 


Maximum access class for stuff on volume */ 


2 mln_access_cla99 bit (72), 


1* 


Minimum access class for stuff on volume */ 


2 password bit (72), 


1* 


not yet used */ 


2 padl (16) fixed bin, 






2 tlflie_motmted fixed bin (71), 


1* 


time mounted */ 


2 timejnap_updated fixed bin (71), 


1* 


time vmap known good */ 


The next two words overlay time vunmounted on pre 


-MRIO systems. This 


forces a salvage If an MRIO pack is mounted on an earlier system. 


2 volmap_verslon fixed bin, 


/* 


version of volume map (currently 1) */ 


2 pad6 fixed bin. 






2 tlme_salvaged fixed bin (71), 


/* 


time salvaged */ 


2 tlme_of_boot fixed bin (71), 


/* 


time of last bootload */ 


2 time_unmounted fixed bin (71), 


/* 


time unmounted cleanly */ 


2 last_pvtx fixed bin. 


/* 


pvtx in that PDMAP */ 


2 padla (2) fixed bin. 






2 err_hist_sixe fixed bin. 


/* 


size of pack error history */ 


2 tlme_last_dmp (3) fixed bin (71), 


/* 


time last completed dump pass started */ 


2 tlme_last_reloaded fixed bin (71), 


/* 


what it says */ 
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.2 pad2 (40) fixed bin, 
2 root, 

3 here bit (1), 

3 root_vtocx fixed bin (35), 

3 shutdown_stat* fixed bin, 

3 pad? bit~(l) aligned, 

3 disk_tabl«_vtocx fixed bin, 

3 di8k~tabl«~uid bit (36) aliftned, 

3 ead.atat* fixed bin, 
:2 volmap_record fixed bin, 
2 size_of_volmap fixed bin, 
:2 vtoe_inap_record fixed bin, 
2 sice_of_vtoc_map fixed bin, 
2 volinap_unit_size fixed bin, 
2 vtoc_origin_record fixed bin, 
2 duniper_bit_roap_reoord fixed bin, 
2 vol_trouble_count fixed bin, 
2 padi (52) fixed bin, 
2 nparts fixed bin, 
2 parts (47), 

3 part char (4), 

3 free fixed bin, 

3 nreo fixed bin, 

3 pads fixed bin, 
2 pad4 (5*64) fixed bini 

del Multies_ZD_String ehar (32) init ("Multies 

/* EIHD IHCLUDE FILE fs_vol_label.incl.pll */ 



r* TRUE if the root is on this pack */ 
r* VXOC index of root, if it is here */ 
!* Status of hierarchy */ 

r* VTOC index of disk table on RPV */ 
r* UID of disk table */ 
f* State of esd */ 

Begin record of 'trolume map */ 
1* Number of records in volume map */ 
'* Begin record of 'VTOC map */ 
'* Number of records in VTOC map */ 

Number of words per volume map section */ 
'* Begin record of VTOC */ 
'* Begin record of dumper bit-map */ 
'* Count of inconsistencies found since salvage */ 

'* Number of special partitions on pack */ 

'* Name of partition */ 

'* First record */ 

'* Number of records */ 



System Volume") static t 
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its.Lncl.pLl aegment Int >ldd> Include contents modified: 11/26/79 1320.6 

entry nodifledi 06/21/85 1914.8 



/* BEGIN INCLUDE FILE its.incl.pll 

modified 27 July 79 by JROavia to add its_unsigned 
Internal format of ITS pointer, including ring-number fie 

del 1 its based aligned, 

2 padl bit (3) unaligned, 
2 segno bit (1.5) unaligned, 
2 ringno bit (3) unaligned, 
2 pad2 bit (9) unaligned, 
2 itsjnod bit i6) unaligned, 

2 offset bit (18) unaligned, 

2 pad3 bit (3) unaligned, 

2 bit_offset bit (6) unaligned, 

2 pad4 bit (3) unaligned, 

2 mod bit (6) unaligned! 

del 1 itp baaed aligned, 

2 pr__no bit (3]> unaligned, 
2 padl bit (27) unaligned, 
2 itpjnod bit (6) unaligned, 

2 offaet bit (18) tmaligned, 

2 pad2 bit (3) tinaligned, 

2 bit_offaet bit (6) unaligned, 

2 pad3 bit (3) unaligned, 

2 mod bit (6) unaligned i 



dol 1 ita_un3ign«d baaed aligned, 
2 padl bit (3) xinaligned, 
2 segno fixed bin (15) unsigned unaligned, 
2 ringno fixed bin (3) unsigned unaligned, 
2 pad2 bit (9) unaligned, 
2 itsjmod bit (6) unaligned, 

2 offset fixed bin (18) unsigned unaligned, 
2 pad3 bit (3) imaligned, 

2 bit_offset fixed bin (6) unsigned unaligned, 
2 pad4 bit (3) unaligned, 
2 mod bit (6) unaligned! 

del 1 itp_unsigned based aligned, /* Just like itp, but with unsigned binary where appropriate */ 

2 pr_no fixed bin (3) unsigned unaligned, 
2 padl bit (27) unaligned, 
2 itp jnod bit (6) unaligned, 

2 offset fixed bin (18) unsigned unaligned, 
2 pad2 bit (3) unaligned, 

2 bit_offset fixed bin (6) unsigned unaligned. 



Ld for follow-on processor */ 

f* declaration for ITS type pointer */ 

segment number within the pointer */ 
ring number within the pointer */ 

'* should be 43(8) */ 

^* word offset within the addressed aegment */ 

'* bit offset within the word */ 

further modification */ 

'* declaration for ITP type pointer */ 
'* number of pointer register to uae */ 

ahould be 41(8) */ 

'* word offaet from pointer register word offset */ 

'* bit offaet relative to new word offset */ 

'* further owdif ieation */ 

* Just like its, but with unsigned binary */ 



*.* 
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2 pad3 bit (3) unaligned, 
2 mod bit (6) tinallgnedi 



del ITS_MODIFIER bit (6) unaligned internal static options (constant) init ("43"b3)i 
del ITP_MOOIFIER bit (6) unaligned internal static options (constant) init ("4:l''b3}i 

/* Em INCLUDE FILE its.inol.pll */ 
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ltt_«ntry . incl .pll 



segment Int >ldd>inelude contents modified: 03/27/82 0429.8 

entry modified! 06/21/85 1915.7 



/* BEGIN INCLUDE FILE ... itt_entry. incl .pll ... Feb 1981 */ 

/* format: styled */ 



del 


itte_ptr 


ptri 


/* 


pointer to entry in ITT */ 


del 


1 ltt_entry 


aligned based (ittej>tr). 


/* 


declaration of single entry in the ITT */ 




2 ne3{t_itt_relp 


bit (18) unaligned. 


/* 


thread of relative pointers */ 




2 pad 


bit (18) unaligned. 








2 sender 


bit (36), 


/* 


id of sending process */ 




2 origin. 




/* 


origin of event message */ 




3 dev_signaL 


bit (18) vmaligned, 


/* 


0 user-event, 1 device-signal */ 




3 rini{ 


fixed bin (17) unaligned. 


/* 


if user-event, sender's validation ring */ 




2 target_id 


bit (36), 


/* 


target process' id */ 




2 channaL_id 


fixed bin (71), 


/* 


target process' event channel */ 




2 message 


fixed bin (71) i 


/* 


event message */ 


/* 


END INCLUDE FILE . . 


. . itt_entry. incl. pll */ 
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kst.,Lncl.pLl 



•«gment ins >ldd>inolude contents modified: 01/30/85 1523.9 

entry modifiedi 06/21/85 1920.0 



/* BEGIN INCLUDE FILE kst.lncl.pll 

Modified March 1976 by R. Br»tt 

Modified November 1984 to remove hdr, Keith Loepere. */ 

del pd8$kstp ext ptr, 
(kstp, kstep) ptrt 

del 1 kst aligned based (kstp) , 
2 lowseg fixed bin (17), 
2 highseg fixed bin (17), 
2 highest_u8ed_^segno fixed bin (17), 
2 Ivs fixed bin (8), 
2 time_of_bootload fixed bin (71), 
2 garbage_colIections fixed bin (17) unaligned, 
2 entrie8_collected fixed bin (17) xinaligned, 
2 free_li8t bit (18) unaligned, 
2 prelinked_ring (7) bit (1) unaligned, 
2 template bit (1) unaligned, 
2 allow_256K_connect bit (1) unaligned, 
2 unused_2 bit (9) unaligned, 

2 uid_hash_bucket (0 : 127) bit (18) unaligned, 

2 kst_,entry (0 refer (kst. lowseg) lO refer (kst. highseg) 

2 Iv Tls256) bit (36), 
2 end_of_kst bit (36) i 

del 1 kste based (kstep) aligned, 
2 fp bit (18) unaligned, 
2 segno fixed bin (17) unaligned, 
2 uaage_count (0i7) fixed bin (8) unaligned, 
2 entryp ptr unaligned, 
2 uld bit (36) aligned, 
2 acce3s_informatlon unaligned, 

3 dtbm bit (36), 

3 extended_access bit (33), 

3 access bit (3), 

3 ex_rb (3) bit (3), 
2 padl bit (3) unaligned, 
2 flags unaligned, 

3 dirsw bit (1), 

3 allow_wrlte bit (1), 

3 priv_lnlt bit (1), 

3 tms bit (1), 

3 tus bit (1), 

3 tpd bit (1), 

3 audit bit (1), 

3 expllclt_deact_ok bit (1), 

3 pad bit (3), 
2 Infcount fixed bin (12) unallgnedt 



/* KST header declaration */ 

/* lowest segment niiiraber described by kst */ 

/* highest segment number described by kst */ 

/* highest segment innimber yet used */ 

/* number of private LVs this process is connected to */ 

/* bootload time during prel inking */ 

/* KST garbage collections */ 

/* KST entries recovered by garbage collection */ 
/* relative pointer to first free kste */ 
/* rings prelinked In process */ 
/* this is a tenvlate kst if set */ 
/* can use 256K segments */ 

/* hash buckets */ 

aligned like kste, /* kst entries */ 
/* private logical volume connection list */ 



/* KST entry declaration */ 

/* forward rel pointer */ 

/* segment number of this kste */ 

/* outstanding initiates /ring */ 

/* branch pointer */ 

/* unique identifier */ 

/* date time branch modified */ 

/* extended access from the branch */ 

/* rew */ 

/* ring brackets from branch */ 



/* directory switch */ 

/* set if Initiated with write permission */ 

/* privileged Initiation */ 

/* transparent modification switch */ 

/* transparent usage switch */ 

/* transparent paging device switch */ 

/* audit switch */ 

/* set If I am willing to have a user force deactivate */ 
/* if dirsw then inferior count else Iv index */ 
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/* END INCLUDE FILE k»t. Inol.pll */ 



kst.lnel.pll Page 30 



lot.lnoL.pll 



segment Int >ldd>LncIiide oontenta modifiedi 08/05/77 1022.4 

entry modifiedi 06/21/85 1914.2 



/* »E6I1H INCLUDE FILE — lot.incL.pll S. Webber 9/74. Modified by R. Bratt 04/76, modified by H. Weaver 7/76 */ 
/* modified by M. Weaver 3/77 */ 

del lotp ptri 

del 1 lot based (Lotp) aligned, 

2 Lp (0>9999) ptr unalignedi /* array of packed pointers to linkage sections */ 

del lot .fault bit (36) aligned static options (constant) init ("111000000000000000000000000000000000"b)i 

/* lot fault has fault code - 0 and offset ■ 0 */ 

del isotp ptrt 

del 1 i»ot based (isotp) aligned, 
2 isp (0:9999) ptr vmalignedi 

del 1 isotl (0 :9999) aligned based, 
2 flags unaligned, 

3 fault bit (2) unaligned, 

3 system bit (1) unaligned, 

3 mba bit (6) unaligned, 
2 f«ult_code fixed bin (8) unaligned, 
2 static_off8et bit (18) unalignedi 



/* END INCLUDE FILE lot.incl.pll */ 



*.* 
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ffio.lnel.pll segm«nt int >Idd>lnclude contents modlfleds 12/15/83 1100. A 

entry modified: 06/21/85 1918.8 

/* 
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*/ 

/* BEGIK! INCLUDE FILE inc.lncl.pll Created Dec 72 for 6180 - WSS. */ 

/* Modified 06/07/76 by Greenberg for mc.reslgnal */ 

/* Modified 07/07/76 by Morris for fault register data */ 

/* Modified 08/28/80 by J. A. Bush for the OPS8/70M CVFU */ 

/* Modified '82 to make values constant */ 



/* words 0-15 pointer registers */ 



del mcpi ptrt 



del 1 mc based (mcp) aligned, 
2 prs (0:7) ptr, 
(2 regs, 

3 X (0:7) bit (18), 

3 a bit (36), 

3 q bit (36), 

3 e bit (8), 

3 padl bit (28), 

3 t bit (27), 

3 pad2 bit (6), 

3 ralr bit (3), 



/* POINTER REGISTERS */ 

/* registers */ 

/* index ragiatars */ 

/* aecumulator */ 

/* q-regist«r */ 

/* axponent */ 

/* timer regiatar */ 

/* ring alarm register */ 



2 sou (0:7) bit (36), 



mask bit (72), 
ip8_temp bit (36), 
erreode fixed bin (35), 
f im_teii^, 

3 unique_index bit (18) unal, 
3 reslgnal bit (1) unal, 
3 fcode bit (17) unal, 
fault_reg bit (36), 
pad2 bit (1), 

cpu_t]rpe fixed bin (2) unsigned, 
eKt_fault_reg bit (15), 
fault_tlme bit (54), 



/* mem controller mask at time of fault */ 
/* Temporary storage for IPS info */ 
/* fault handler's error code */ 

/* unique index for restarting faults */ 

/* recon^ute signal name with fcode below */ 

/* fault code used as index to FIM table and SCT */ 

/* fault register */ 

/* L68 « 0, DFS8/70M - 1 */ 

/* extended fault reg for DFS8/70M CPU */ 

/* time of fault */ 



2 ais_info (0:7) bit (36)) unalignedi 



del (apx fixed 


bin 


inlt 


(0), 


abx 


fixed 


bin 


Inlt 


(1). 


bpx 


fixed 


bin 


Inlt 


(2). 


bbx 


fixed 


bin 


inlt 


(3), 


Ipx 


fixed 


bin 


inlt 


<4), 


Ibx 


fixed 


bin 


inlt 


(5), 


spx 


fixed 


bin 


inlt 


(6), 


abx 


fixed 


bin 


inlt 


(7)) 



internal static options (constant) i 
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del scup ptrt 

del 1 sou based (scup) aligned, 



/* WORD (0) 

(2 ppr, 

3 prr bit (3), 
3 par bit (15), 
3 p bit (1), 

2 apu, 

3 xsf bit (1), 

3 sdwm bit (1), 

3 sd_on bit (1), 

3 ptwm bit (1), 

3 pt_on bit (1), 

3 pilap bit (1), 

3 dsptw bit (1), 

3 sdwnp bit (I), 

3 sdwp bit (IK 

3 ptw bit (1), 

3 ptw2 bit (IK 

3 fap bit (1), 

3 fan^ bit (1), 

3 fabs bit (1), 

2 £ault_cntr bit (3), 



/* WORD (1) */ 

2 fd, 

3 Iro bit (1), 
3 oeb bit (1), 
3 e_off bit (I), 
3 orb bit (1), 
3 r_off bit (1), 
3 owb bit (1), 
3 w_off bit (1), 
3 no_ga bit (1), 
3 ocb bit (1), 
3 ocall bit (1). 
3 boc bit (1), 
3 inret bit (1), 
3 crt bit (1), 
3 raLr bit (1), 
3 am_er bit (1), 
3 oosb bit (1) , 
3 paru bit (1), 
3 pari bit (1) , 
3 onc_l bit (1), 
3 onc_2 bit (1), 



/* SCU DATA */ 



/* PROCEDURE POINTER REGISTER */ 
/* procedure ring register */ 
/* procedure segment register */ 
/* procedure privileged bit */ 

/* APPENDING UNIT STATUS */ 

/* ext seg flag - IT modification */ 

/* match in SDU Ass. Hem. */ 

/* SDW Ass. Mem. ON */ 

/* match in PTU Ass. Mem. */ 

/* PTW Ass. Mem. ON */ 

/* Instr Fetch or Append cycle */ 

/* Fetch of DSPTW */ 

/* Fetch of SDW non paged */ 

/* Fetch of SDW paged */ 

/* Fetch of PTW */ 

/* Fetch of pre-paged PTW */ 

/* Fetch of final address paged */ 

/* Fetch of final address non-paged */ 

/* Fetch of final address absolute */ 

/* number of retrys of EIS Instructions */ 



'* FAULT DATA */ 

'* illegal ring order */ 

'* out of execute bracket */ 

'* no execute */ 

'* out of read bracket */ 

'* no read */ 

'* out of write bracket */ 

'* no write */ 

'* not a gate */ 

'* out of call bracket */ 

'* outward call */ 

* bad outward call */ 
'* Inward return */ 

'* cross ring transfer */ 

* ring alarm register */ 

* associative memory fault */ 

* out of segment bounds */ 
'* processor parity upper */ 

* processor parity lower */ 

* op not complete type 1 *f 

* op not complete type 2 */ 
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2 port_stat, 
3 iai bit (4), 
3 Lac bit (3), 
3 eon_chan bit (3), 

2 fijnum bit (5), 
2 £i_flag bit (1), 



/* WORD (2) */ 

2 tpr, 

3 trr bit (3), 
3 tsr bit (15), 

2 pad2 bit (9), 

2 cpu_no bit (3), 

2 d«Lta bit (6), 



/* WORD (3) */ 

2 words bit (18), 



2 t«r_stat. 



3 


tsna, 








4 pm 


bit 


(3), 




4 prv 


bit 


(1), 


3 


tanb, 








4 pm 


bit 


(3), 




4 prv 


bit 


(1), 


3 


tsnc, 








4 pm 


bit 


(3), 




4 prv 


bit 


(1), 


tpr_tbr 


bit 


(6), 



/* WORD (4) */ 

2 ilc bit (18), 

2 ir, 

3 zero bit (1), 

3 neg bit (1), 

3 carry bit (1), 

3 ovfl bit (1), 

3 eovf bit (1), 

3 aufl bit (1), 

3 oflm bit (1), 

3 tro bit (1), 

3 par bit (1), 

3 parm bit (1), 



/* PORT STATUS */ 
/* ilLegal action linoa */ 
/* illegal aotion channel */ 
/* connect channel */ 

/* (fault /interrupt) numbez */ 

/* 1 -> fault, 0 -> interrvqit */ 



/* TEMPORARY POINTER REGISTER */ 
/* tenqporary ring register */ 
/* temporary aegment register */ 



/* CPU number */ 

/* tally modification DELTA */ 



1* 


TSR STATUS for 1,2, &3 


word 


1* 


Word 1 


status */ 




1* 


Word 1 


PR number */ 




1* 


Word 1 


PR valid bit 


*/ 


1* 


Word 2 


status */ 




1* 


Word 2 


PR number */ 




/* 


Word 2 


PR valid bit 


*/ 


/* 


Word 3 


status */ 




/* 


Word 3 


PR number */ 




/* 


Word 3 


PR valid bit 


*/ 


/* 


TPR.TBR 


field */ 





/* INSTRUCTION COUNTER */ 

/* INDICATOR REGISTERS */ 

/* zero indicator */ 

/* negative Indicator */ 

/* carryry Indicator */ 

/* overflow indicator */ 

/* eponent overflow */ 

/* exponent underflow */ 

/* overflow mask */ 

/* tally runout */ 

/* parity error *l 

/* parity mask */ 
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3 bra bit (1) ,, 
3 tru bit 
3 mlf bit 
3 aba bit 
3 h«x bit 
3 pad bit 



(1), 
<1), 
<1), 
(3), 



/* '"■bar mode */ 
/* truncation mode */ 
/* multi-word instruction mode */ 
/* absolute mode */ 
/* hexadecimal exponent mode */ 



/* 



WORD (5) 

2 ca bit (18), 

2 cu, 

3 r£ bit (1), 
3 rpt bit (1), 
3 rd bit (1), 
3 rl bit (1), 
3 pot bit (1) 
3 pon bit (1) 
3 xde bit (1) 
3 xdo bit (1) 



*/ 



3 poa bit 
3 rf 1 bit 
3 its bit 
3 if bit 



(1) 
(1) 
(1) 
(1). 



/* COMPUTED ADDRESS */ 



CONTROL UHIT STATUS */ 

on first cycle of repeat instr */ 

repeat instruction */ 

repeat double instruction */ 

repeat link instruoiton */ 

IT modification */ 

return type instruction */ 

XDE from Even location */ 

XDE from Odd location */ 

operation preparation */ 

tells CPU to refetch instruction */ 

ITS modification */ 

fault occured during instruction fetch */ 



2 cpu_ta8 bit (6)) unaligned. 



/* computed tag field */ 



/* WORDS (6,7) 

2 even_lnst bit (36), 
2 odd_inst bit (36) t 



*/ 



/* even instruction of faulting pair */ 
/* odd instruction of faulting pair */ 



/* 



ALTERNATE SCU DECLARATION 



*/ 



del 1 scvuc based (scup) aligned, 
(2 padO bit (36), 



fd. 


/* 


GROUP II FAULT DATA */ 


3 Ian bit (1), 


/* 


illegal segment number */ 


3 loc bit (1), 


/* 


Illegal op code */ 


3 la_atn bit (1), 


/* 


illegal address - modifier */ 


3 isp bit (1), 


/* 


illegal slave procedure */ 


3 ipr bit (1), 


/* 


illegal procedure */ 


3 nea bit (1), 


/* 


non existent address */ 


3 oobb bit (1), 


/* 


out of bounds */ 


3 pad bit (29), 







*.* 
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2 pad2 bit (36), 

2 pad3a bit (18), 

:2 tar_st«t (0:2), 
3 prn bit (3), 
3 prv bit (1), 

2 pad3b bit (6)) unaligned, 

2 pa.d45 (0:1) bit (36), 

2 Instr (0:1) bit (36); 

I* BHD INCLUDE FILE mc.inoL.pLl */ 



/* TSR STATUS as an ARRAY */ 
/* PR number */ 
/* PR valid bit */ 



/* Instruotlon ARRAY */ 



mo. incl.pll 
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pds . cda 



segment ins >].dd>hard> source contents modified: 05/03/85 0800.2 

entry modified s 06/21/85 1913.3 



* * 

* Copyright, (C) Honeywell Information Systems Inc., li>82 * 

* * 

* Copyright (o) 1972 by Massachusetts Institute of * 

* Technology and Honeywell Information Systems, Inc. * 

* * 



/* PDS - The Process Data Segment 

Last modified (Date and reason) : 
2/6/76 by S. Webber Initial coding 

9/17/76 by R. Bratt to add seg_fault, bounds_fault, vtcio_^,read, and vtoejvrita meters. 

11/03/76 by M. Weaver to extend stack header 

04/20/77 by M. Weaver to delete rntp and 7/77 to add nam«i tea9late_pds 
06/07/78 by E. Donner to add ring_events (to prevent delayed ipc wakeups) 
05/10/79 by B. Marguliea to eliminate exmode_leveI 
05/09/79 by Mike Grady to use shared ring 0 stacks 

08/17/79 by J. A. Bush for exp under /overflow restart switches & cache parity diagnostics 
02/28/80 by B. Marguliea to use the include file for the default overflow 
08/26/80 by J. A. Bush for the DPS8/70M CPU 
value . 

02/23/81 by J. Bonglovannl to remove temp_mode_reg (moved to prds$mode_reg_enabIed) 
03/81 by E. Donner to remove next_itt and ect_polntera 

3/82 BIM for lock_array cleanup. 
11/82 by J. Bonglovannl to make force_write_limit per-ring 

2/83 by E. N. Kittlltz for hf p_exponent_enabIed . 

830621 BIM for level improvements. 
10/83 by E. N. Kittlltz to resurrect obsolescent network_ptbl_idx for MR10.2. 

83-11-02 by E. N. Klttlits for block_lock_count in low page, hex exponent control. 

83-11-21 BIM to Inhibit quota and save history registers by default 
in the initializer's process. 

83-12-01 E. N. Kittlltz for restart hex overflow fault control 

83- 12-03 BIM to clear trace header properly, (and new trace format) 

84- 12-10 Keith Loepere for throttle_segment_state_change8 and other 

covert channel related variables. 
1985-01-21, BIM: «droln_privlloges to record ring 1 prlv settings. 
1985-04-08, BIMi no_audlt_ringl_fs_obJect_ops to suppress auditing 
while in the mseg primitives and RCP. 

*/ 

/* format: style3, idind25 */ 
pds : 

procedure i 

/* This program creates the pds data base */ 
/* Automatic */ 
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del 
del 



1 cdsa 
code 



/* Constants */ 



del 
del 



pdsname 
excLudajpad 



aligned like cds_argst 
fixed bin (35) i 



char (3) aligned static Inlt ("pds") options (constant}} 

(1) char (32) aligned static options (constant) Inlt ("pad*")t 



/* Bulltlns */ 
del 



(addr, bin, bit, decimal, divide, float, hbound, mod, null, ral, alee, string, unspeo) 
bulltlnt 



/* Entries */ 

del eom_err_ 

del ereate_data_segment_ 

del get_temp_segment_ 

del release_teDip_segment__ 

del hcs_$ohname_f lie 

del get_wdlr_ 



entry options (variable) i 

entry (ptr, fixed bin (35)) i 

entry (char (*), ptr, fixed bin (35) )i 

entry (char (*), ptr, fixed bin (35) )t 

entry (char (*), char (*), char (*), char (*), fixed bin (35) )i 
entry () returns (char (168) )i 



/* External Static */ 

del error_table_$aegnamedup fixed bin (35) exti 
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del 


pdsp 


ptrt 


del 


1 pda 


aligned based (pdap). 




2 page_fault_data 


like mc. 




2 flm_data 


like me. 




2 aignal_data 


aligned like mo, 




2 hLstoKy_r«g_data 


(64) fixed bin (71), 




2 proce,ts_group_Ld 


char (32), 




2 cpu_tline 


fixed bin (52), 



2 


virtual delta 


fixed bin (52), 


2 


Yirtual_t iine_at_el ig Ibil ity 






fixed bin (52), 


2 


teii)p_l 


fixed bin (71), 


2 


temp_2 


fixed bin (71), 


2 


tlrae_S. 


fixed bin (52), 


2 


tlme_v_teinp 


fixed bin (52), 


2 


f lin_v__teinp 


fixed bin (52), 


2 


f iin_v_delta 


fixed bin (71), 


2 


save_hlatory_regs 


bit (1) aligned. 


2 


hregs_savod 


bit (1) aligned. 


2 


last_»p 


ptr. 


2 


apt_ptr 


ptr, 


2 


arg_l 


fixed bin (71), 


2 


arg_2 


fixed bin (71), 


2 


arg_3 


fixed bin (71), 


2 


arg_4 


fixed bin (71), 


2 


acces»_authoi:ization 


aligned like alm_tea^late 


2 


basa_«ddr_reg 


bit (18) aligned. 


2 


alarm__rLng 


fixed bin (3), 


2 


pxas_«rga_invalid 


bit (36) aligned, 


2 


proceaaid 


bit (0) umallgned, 


2 


procefla_Ld 


bit (36) aligned, 


2 


vtime _oount 


fixed bin. 


2 


patep 


bit (0) unaligned, 


2 


datep 


bit (18) aligned, 


2 


wakeup_£lag 


bit (36) aligned, 


2 


pc_call 


bit (36) aligned, 


2 


audltflaga 


bit (36) aligned. 


2 


<juota_ Inlilb 


fixed bin aligned. 


2 


cove r t_e vent_count 


fixed bin. 


2 


page waits 


fixed bin. 


2 


nvimber_of_page8_in_uae 






fixed bin. 


2 


post_purged 


fixed bin. 


2 


connect_pending 


bit (1) aligned. 


2 


8egmertt_fault8 


fixed bin (35), 


2 


boundt_faults 


fixed bin (35), 


2 


vtoc_reads 


fixed bin (35), 


2 


vtoc_wrltes 


fixed bin (35), 


2 


mc_tr8.ce_seg 


fixed bin. 


2 


mc_trace_sw 


bit (2) aligned, 


2 


stack_0_sdwp 


ptr aligned. 



*.* 
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* MC for page faults and timer runouts */ 

* MC for normal faults */ 

* storage for MC being signalled */ 

* this must follow signal data */ 

* user id for current process */ 

* number that when subtracted from clock reading gives 
virtual cpu time */ 

* teoiporary used in calculating VCPU time */ 

* temporary used in calculation of VCPU time */ 

* temporary */ 

* temporary */ 

* page fault metering time *l 

* temporary used in calculating VCPU time */ 

* VCPU temporary for the FIM */ 

* VCPU temporary for the FIM */ 

* - "i"b if history registers are to be saved */ 

* m "i"b if history regs were saved */ 

* stack pointer at getwork time */ 

* pointer to this process's APT entry */ 

* argument for pxas *i 

* argument for pxas */ 

* argument for pxas */ 

* argument for pxss */ 

* access authorization for the process */ 

* for BAR mode use */ 

* setting for ring alarm regiater */ 

* used by pxss masking /arg copying code */ 

* process ID (added segdef ) */ 

* process ID */ 

* depth counter used in VCPU calculation */ 

* (added segdef for datep) */ 

* rel pointer to ASTE for dseg */ 

* flag indicating type of wakeup */ 

* flag saying type of wait */ 

* bits indicating types of auditing to do */ 

* ON if quota checking to be inhibited */ 

* count of covert channel related segment state change events */ 

* page faults */ 

* used in calculating memory units */ 

* number of post purgings */ 

* turned on for delayed connects to be resent by fim */ 

* count of segment faults taken by this process */ 

* count of bounds faults taken by this process */ 

* vtoc read I/Os done for this process */ 

* vtoc write I/Os done for this process */ 

* seg number of object segment being traced */ 

* switch for H. C. Tracing "ll"b -> trace on */ 

* ptr to stack sdw in dseg */ 
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2 staclc_0_ptr 


ptr aligned. 


/* 


ptr to base of ring 0 stack (wired for esd) */ 


2 tc argp 


ptr , 


/* 


arg ptr used by tc 


2 te mask 


bit (72) aligned. 


/* 


save tc mask *l 


2 axpjundf l_r«st 


bit (2) aligned, 


/* 


fim restarts underflow: 'I'b - binary, 'Ol'b » hex */ 


2 •xp_ovfl_rest 


bit (2) aligned. 


/* 


fiffl restarts exp overflow: 'I'b ■ binary, 'Ol'b « hex */ 


2 eovfl_valu« 


bit (72) aligned. 


/* 


value DFLD'ed by fim on restart binary overflow */ 


2 hex_«ovfL_vaLu« bit 


(72) aligned, 


/* 


value DFLD'ed by fim on restart hex overflow */ 


2 cpar_err_data 


bit (72) aligned. 


/* 


cache parity error data (from cache) */ 


2 cpar_niem__data 


bit (72) aligned. 


/* 


cache parity error data (from memory) */ 


2 cpar_lnfo 


bit (36) aligned. 


/* 


diagnose flag, cache level and absaddr f */ 


2 h£p_axponent_enabled bit (1) aligned, 


/* 


user allowed to set IR hex exp bit */ 


2 pr«_empt__poll_return pointer. 






2 block lock count 


fixed bin. 


/* 


count of locks held */ 


2 throttle_aeginent_state_changes bit (1) aligned,/' 


* limit bandwidth of segment state covert channels */ 


2 fir9t_covflrt_event tine fixed bin (52), 






2 pad £of trace inodl6 


(6^ fixed bin 






2 trace 


f306) fixed bin ^71) 


/* 


system trace data */ 






/* 


pds$traca -I- 16 defines the pds for idle proos */ 


2 timer time out 


fixed bin (52) , 


/* time out time for the prooess */ 


2 timer cliannel 


fixed bin C71) 


/* 


event channel for time out event */ 


2 term channel 


fixed bin (71) « 


/* 


channel used to signal process termination */ 


2 term proo 


bit (36} ftlignedf 


/* proeeas ID of proeesa to signal term process */ 


2 pll maohine 


fixed bln« 


/* nonzero if we do pll-like things */ 


2 validation level 


fixed bin (3) i 






2 condition name 


ellKnedp 


/* 


ACC string for condition name */ 


3 len ~ 


fixed bin (8) unellgned^ 






3 chare 


WAMfcifc UEftM-ili Ai^A&VU 1 






2 pad obsolete 


bit (36) aligned. 






2 ipsjnaak 


(0>7) bit (35) aligned. 


/* 


IPS masks */ 


2 auto_iiia8k 


(0i7) bit (36) aligned. 


/* 


array of automatic masks for IPS signals */ 


2 ring_alarm_val 


(0i7) fixed bin. 


/* 


used in cheeking validation level changes */ 


2 lock~id 


bit (36) aligned. 


/* 


UIO used in some locking */ 


2 mo_trace__buf 


ptr tinallgned. 


/* 


packed ptr to mc_traoe wired buffer */ 


2 pad_end_of_page_0 


bit (0) unaligned. 






2 pathname_am 


aligned like pam. 


/* pathname associative memory */ 


2 initial_procedure 


ptr, 


/* 


first procedure executed in a new prooess */ 


2 account_id 


char (32) aligned, 


/* 


not used yet */ 


2 acceas_name 


aligned, 


/* 


alternate form of prooess group id */ 


3 user 


char (32) aligned. 






3 project 


char (32) aligned. 






3 tag 


char (32) aligned, 






2 home_dir 


char (168) aligned, 


/* home directory */ 


2 process_dlr_name 


char (32) aligned, 


/* 


name of process directory */ 


2 wdlr 


(0:7) ptr, 


/* 


pointers to per-ring working directories */ 


2 wdlr_uld 


(0i7) bit (36) aligned. 


/* 


DID of per-ring working directories */ 


2 transparent 


bit (36) aligned. 


/* 


transparent usage, mod, pd switch */ 


2 Ltt_head 


bit (18) aligned. 


/* 


top of present ITI list */ 


2 max_access_authorizatLon 








aligned like aim_teiiiplate. 








/* 


owx authorization this user can attain */ 


2 stacks 


(0:7) ptr, 


/* 


per-ring stack pointers */ 


2 kstp 


ptr, 


/* 


pointer to start of KSX */ 


2 events_j)eading 


bit (36) aligned. 


/* 


special vakeups pending */ 


2 special_channala 


bit (36) aligned. 


/* 


special channels assigned */ 


2 event_masks 


(7) bit (36) aligned. 


/* 


per-ring mask for special channels */ 


2 initial_ring 


fixed bin (3), 


/* 


initial ring of execution for the process */ 
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Xpag« i 



2 interinipt_rlng 
2 highest_rlng 
2 prell.nked_clng 
2 unlqua_acu_lndex 
2 max_Iot_slze 
2 lot_«t«ck_slEe 
2 clr_stack_slze 
2 Ilnk_.inaters_bina 
2 llnk_roeters_tlma3 
2 Ilnk_,metar3_pgwaita 
2 dinpr_,copy_dLraegp 
2 dmpr_pvLd 
2 dinprjiivtx 
2 £lrat_call 
2 iiic_,aave_araa 
2 mc__aave_ptr 
2 mc_8ava_llmlt 
2 u8aable_Iot 
2 rlng_avanta 
2 force write limit 



fixed bin (3), 
fixed bin (3), 
bit (8) aligned, 
bit (36) aligned, 
(0:7) fixed bin, 
(0i7) fixed bin, 
(Os7) fixed bin, 
(4) fixed bin, 
(4) fixed bin (30), 
(4) fixed bin, 
ptr, 

bit (36), 
fixed bin, 
fixed bin, 
bit (18) aligned, 
bit (18) aligned, 
bit (18) aligned, 
bit (8) aligned, 
bit (36) aligned, 
(Oi7) fixed bin. 



2 ipe_var8 
3 ap 
3 retsw 

3 ■ave_entry_ret 

3 truncated_stacks 
3 chan 

3 block_start_steps 

3 stk_teinp 
2 lpc_block_retui:n 
2 avg_block_ateps 
2 adinln_prlvileges 
2 no_audlt_rlngl_f s_obj 
2 pad_£or_data_inodl6 
2 data 



aligned, 
pointer vtnal, 
fixed bin (35), 
fixed bin (35), 
fixed bin (35), 
fixed bin (71), 
fixed bin (35), 
fixed bin (35), 
bit (36), 

fixed bin (35, 18), 
bit (36) aligned, 
ect_ops bit (1) aligned, 
(6) fixed bin (35), 
bit (0) aligned I 



/* lowest ring in which IPS interrupts are allowed */ 

* highest ring in which process can run */ 

* bit(i) is ON if ring (i) is prelinked */ 

* used to tag MC */ 

* sizes lots can grow to */ 

* size of lot in stack (0 -> lot not in stack) */ 

* size of CLR in stack */ 

* histograms of linkage faults */ 

* histogram of linkage fault times */ 

* histogram of linkage faults PF's */ 

* ptr to temp segment into which dirs are copied */ 

* pvid of volume being duoiped */ 

* pvtx of volume being dunked */ 

* ON until leave ring zero once */ 

* rel pointer to start of saved MC area */ 

* ptr to next me save place */ 

* max address where MC can be saved */ 

* indicates whether lot can be referenced */ 

* per-ring indicator that itt messages copied to eot */ 

* limit on force-writing */ 

* Following must be doubleword aligned I */ 

* holds state of fast_hc_ipc at block */ 



call get_tenq>_segment_ ("pds", pdsp, code)( 



/* ipc block return address */ 

/* There is: a 1 here for each privilege that must be reset on exit from ring 1 */ 
/* Ring 1 has asked to turn off ring 0 auditing */ 

/* to mark end of PDS for MC save area */ 

/* Returns ZEROS */ 



/* Now begins the initialization */ 

pds.process_group_id >■ "Initializer. SysDaemon.z"! 



pds. access_authorlzatlon. categories ~ (18)''0"bt 
pds. access_authorlzatlon. level 0| 
pds.acces9_authorlzatlon.dlr « "l^bt 
pds.access_authorlzatlon.seg ~ ''l''b| 
pds.access_authorlzatlon.rcp " "l"b| 
pds.access_authorlzatlon.lpo » "l"bt 
pds.access_authorization.soos ■ "I'bt 



/* for initializer */ 



/*..*/ 



pds .max_access_authorlzatlon. categories " (18)''l"b || (18)''0"bi 
pds .max_acces s_authorizat ion. level 7t 



pds . quota_lnhlb •■ It 
pds.vtime_count ■ -It 



/* initializer ignore rqover until it is enabled */ 



* . * 
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pds. process Id " (36)"l"bi 
pds.look_ld - (36}"l"bi 
pds.pLl_maehlne " It 
pds.lpsjowsk (*) - (35)*'l"bi 
pd8.forc«_write_LiaiLt (*) - 1| 

pds.save_hLstory_ress ■ "l"bi 
pds.hx«gs_sav«d ■ "0"bi 
pds.hLstory_x«g_data (*) Oi 

pda .mc_trac«_buf ■« null i 
pds.iBc_trac«_aw ■ "0"bj 
pds.ino_traee_flcg " Ot 

pds.aov£I_vaIu« - unspac (De£ault_axponant_control_ovarfLow_vaLua)t 
pda.hex__eov£l_valua • unspac (De:fauLt_hex_«xpon«nt_oontrol_ovarflow_valua) i 

/* sat dafault axp ovairflow rastart valua */ 

pd8.axp_ovfL_i:est, pds . axp_undf I_xast - "O^bi ^ 

pds . stack_0_sdwp <■ nuLIi 
pds . stack_0_ptr ■ nulLi 
pds.pad_for_t]raca_fflodl6 (*) Oi 

unspac (pds.traca) ■ ""bt 
traca_ptr " addr (pds.traca) i 

trace. La8t_avallabLe " divide (hbound (pds.traca, 1) * sise (paga_trace_antry) - 8, 2, 17, 0)t 

trace . threshold - .75 * float (decimal ( trace. last_avaLLabLe) ) t 

pds. inltial_j>rocedure - nulli 

pds. aocess_name. user — "Initialiser"! 
pds. access_naine. project " "SysDaemon"] 
pds.access_name.tag - "e"i 

pds.home_dir - ">system_oontrol_l"i 

pds.procesa_dir_name ■• ">process_dir_dir>lzsszzssbBBBBBB"i 

pds.wdir (*) - nulli 
pds.wdir_uid (*) - "0"bi 



pds. stacks (*) > nulli 

pds . dmpr_pvid ■> "0"bj 
pda . dmpr_pvtx - 0| 
pds.dinpr_copy_dirsegp ■ nullt 

pda.kstp ~ nulli 
pds.f lrst_call - 1| 
pds. initial_ring » 1| 
pds . int«rrupt_ring ■ 4 1 
pds.highest_ring 7i 

pds.max_lot_siza (*} - 1024 i 



*.* 
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pds .mc_8ave_area " rel (addr (pds.data))i 
pd8.mc_8ave_ptr ■■ rel (addr (pds.data))i 

pds.mc_save_Iiinlt - bit (bin (4096» 18), 18) i /* Allow for as many as fit In 4K. */ 

/* Now make some checks on alignment of certain variables */ 

call check (addr (pds. ipc_vars) , "ipc_vara''> 2)8 

call check (addr (pds.page_fault_data) , ''page_f ault_data" , 16) i 

call check (addr (pds. trace), "trace", 16) i 

call check (addr (pd8.algnal_data) , "slgnal_dato'', 16) i 

call check (addr (pds.eoyfl_value) , "eovfl.valun"!, 2)t 

call check (addr (pds.hex_eovfl_value) , "hex_eovf]L_value", 2)i 

call check (addr (pds. data), "data", 16) i 

if bin (rel (addr (pd8.pad_end_of_page_0)), 18) ^» 1024 

then call oom_err_ (0, pdsname, "Wired portion must end at 1024") i 

/* Now set up call to create data base */ 

cdsa. sections (l).p " addr (pds)i 
cdsa. sections (l).len size (pds)i 
cdsa. sections (1) .struct^name " "pds"; 

cdsa.seg_name » "pds"t 
cdsa.nvun_exclude_names ■■ It 
cdsa.exclude_arrayjptr •■ addr (exclude_pad) i 

string (cdsa. switches) - "0"bi 
cdsa. switches. have_text " "l"bj 

call create_data_segment_ (addr (cdsa) , code) i 

call relea8e_temp_segroent_ ("pds", pdsp, code)i 

call hcs_;$chname_£ile (get_wdlr_ (), "pds", "", "teo^late^pds", code)t 
if code 0 

then if code error__table_$segnamedup 

then call oom_err_ (code, pdsname, "Unable to add name template jpds .") i 



*.* 
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check: 

proc (where, message, modulo) i 



del where ptri 

del message char (*)i 

del modulo fixed bLni 

del remainder fixed blni 



remainder ■ mod (bin (rel (where), 18), modulo)! 
If remainder 0 

then call com_err_ (0, pdsname, "The variable ^a 
message, (modulo - remainder), modulo) i 



end check I 
Xpagai X Include aim_teinplate t 
Xpagei X Include cds_argsi 
Xpagai X Include exponent_control_infoi 
Xpagei X include met 
Xpagai X include pathname_ami 
Xpagei X include sys_tracei 

end pdst 



*.* 
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'^d words away from being aligned on a M-word boundary.**. 
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prda . cds 



segment ins >l,dd>hard>source contents modifledi 04/03/85 0959.2 

entry modifledi Ofi/21/85 1913.1 



/ * ******************************************************* 

* * 

* Copyright, (C) Honejrwell Information Systems Inc., 1982: * 

* * 
*********************************************************** */ 

/* PROS - The Proceaaor Data Segment and Processor Stack. 
/* Last modified (Date and reason)! 
2/6/76 by S. Webber Initial coding 

6/15/77 by M. Weaver to null signal and set pointers 
8/25/80 by J. A. Bush for the dps8/70m cpu 
2/22/81 by J. Bongiovanni for fast_conneot_code 
6/27/81 by J. Bongiovanni for idle_temp 

10/11/83 by R. Coppola to adjust for size change of fast connect code 

and validate that aptjptr& ignore jpl are on correct mod 

*/ 



/* ****************************************************** 

* * 

* * 

* Copyright (c) 1972 by Massachusetts Institute of * 

* Technology and Honeywell Information Systems, Inc. * 



****************************************************** * / 

prds t proc ; 

/* This program creates the prds data base */ 

/* Automatic */ 

del i fixed bini 

del 1 cdsa aligned like cds_argsi 

del code fixed bin (35) i 

/* Static */ 

del prdsname char (4) aligned static init ("prds") optiono (constant) t 

dol excludejpad (1) char (32) aligned static options (constant) init ("pad*")] 

/* The following must correspond to the size of the fast connect code in 
fast_connect_init 

del FAST_CONNECT_CODE_WORDS init (72) fixed bin int static options (constant) i 
/* Builtina */ 

del (addr, baseptr, bin, mod, null, ptr, rel, size, string, unspec) builtint 



*/ 
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/* Entries */ 

del com_err_ entry options (variable) t 

del create_data_seginent_ entry (ptr, fixed bin (35)) i 

del get_teiii|>_segment_ entry (char (*), ptr, fixed bin (35)) i 

del celea9e_teBqp_segiiient_ entry (char (*), ptr, fixed bin (35) )i 
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del prdsp ptrt 



del 1 prda aligned based (prdsp), 

2 header aligned like stack_header, 

2 lnterrupt_dat:a aligned like mc, 

2 flm_data aligned like mo, 

2 sys_trouble_data aligned like mo, 

2 lgnore_data aligned like sou, 

2 lltemp~£lxed bin (71), 

2 last_reoorded_tlffle fixed bin (71), 

2 ldle_j>tr ptr, 

2 almulatedjnask fixed bin (71), 
2 am_data bit (0), 

2 ptv_am_rega (4*16) fixed bin (35), 

2 ptw_am_ptra (4*16) fixed bin (35), 

2 sdw~am_regs (4*16) fixed bin (71), 

2 sdw'anTptrs (4*16) fixed bin (35), 

2 processor_pattern bit (8) aligned, 

2 proceasor_tag fixed bin (3), 

2 la8t_tlmer_settlng bit (27) aligned, 

2 depth fixed bin, 

2 mode_reg bit (36) aligned, 

2 cache_luf_reg bit (36) aligned, 

2 fault_reg bit (72) aligned, 

2 aptjptr ptr, 

2 ldle_temp fixed bin (71), 



* standard stack header */ 

* HC for Interrupts */ 

* MC for oonnect faults, timer runouts */ 

* MC for saved sys trouble data */ 

* for SCU data to be Ignored at certain times */ 

* ten^orary used by 11 (surprise!) */ 

* used by traffic control */ 

* pointer to Idle process APIS for this processor */ 

* simulated system controller mask register */ 

* to get addr of associative memory data block */ 

* page table regs (4 sets of 16 for dps8/70m) */ 

* page table pointers (4 sets of 16 for dps8/70m) */ 

* segment desc. regs (4 sets of 16 for dps8/70m) */ 

* segment desc. pointers (4 sets of 16 for dps8/70m) */ 

* 1 bit ON for this processor */ 

* CPU tag from maintenance panel */ 

* last timer value loaded for this CPU */ 

* depth In eligible queue for running process */ 

* mode register for this processor */ 

* cache mode register for this CPU */ 

* place to store the fault register */ 



-> apte running on this cpu 
used by Idle process 



*/ 
*/ 



/* The following contains code used for handling connect faults for this processor 



*/ 



2 fast_connect_code (FAST_CONNECT_CODE_WORDS) bit (36) aligned. 



2 fast_connect_code_end bit (36) aligned, 
2 mode_reg_enabled bit (36) aligned, 
2 pad_mod_8 (2) fixed bin, 
2 lgnore_pl (8) bit (36) aligned, 
2 pad_mod_16 (16) bit (36) aligned, 
2 processor^stack aligned like 3tack_framet 



/* marker for fast_connect_lnlt 
/* used to set mode register 

/* used by wired flm to spl/lpl */ 

/* first stack frame location */ 



*/ 
*/ 



prds . cds 
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call get_teinp_seginent_ ("prda", prdsp, eode)i 
unspec (prds) ■ ""bt 



/* Now nwke lome checks on alignment of certain variables */ 

call check (addr (prd8.1dle_ptr), "ldle_ptr", 2)i 

call check (addr (prds .processor_stack) , "processor_stack'*, 16) t 

call check (addr (prds .ptw_aiii_regs) , ''ptw_aiii_regs", 16)t 

call check (addr (prds .sdw_ain_regs) , '*sdw_am_reg8", 32) i 

call check (addr (prds.fast_connect_code), "fast__connect_code'', 2)i 

call check (addr (prds.Lgnore_pl), "lgnore_pl",8) i 

call check (addr (prds . aptjptr) , "aptjptr", 2)i 

/* Now net up call to create data base */ 

edsa. sections (l).p ■ addr (prd8)t 
cdsa. sections (l).len- size (prds)i 
cdsa. sections (1) .struct_naine ■ "prds*! 

cdsa.seg_naine "prds*! 
cdsa.nuin_exclude_naffles li 
edsa.exclude_array_ptr > addr (exolude_pad) t 

string (cdsa. switches) "• "D'hi 
cdsa. switches. have_text "I'bi 

call create_data_segiiient_ (addr (cdsa), code)t 

call release_teinp_segiiient_ ("prds", prdsp, code)i 
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checks proc (whore, message, modulo) i 

del where ptrt 

del message char (*)i 

del modulo fixed bint 

if mod (bin (rel (where), 18), modulo) 0 

then call com_err_ (0, prdanamc, "The variable '^a is not aligned on a ^d-word boundary.", message, modulo) i 
end check, t 
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X include cds_argsi 



prds . cds 
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X Include stack_headeri 



prds . cds 
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% Ln<;Iude stack_£ra(net 
X Ln<ilude mci 

end prdsi 
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ptw.168.lncl.pll 



segment ln< >ldd>inolude contents modlfiedt 03/27/82 0430.2 

entry modified! 06/21/85 1915.7 



/* BEGIN INCLUDE FILE ... ptw.168. Incl.pll ... 02/26/81, for ADP conversion */ 

/* Note: This include file has an ALM counterpart made with oif . Keep it up to data */ 



del 


1 


168__corej>tw aligned based (ptp). 


/* 


In-core page descriptor */ 




2 


frame fixed bin (14) unsigned unaligned. 


/* 


Core frame number */ 




2 


padl bit (4) unaligned. 








2 


flags unaligned like 168_ptw_f lagsi 






del 


1 


168_ptw aligned based (ptp), 


/* 


General declaration for out-of-core PTW */ 




2 


add bit (18) unaligned. 








2 


flags like 168_ptw_flags unaligned! 






del 


1 


168_apecial_ptw aligned baaed (ptp) like 168_ptWf 


/* 


Page is somewhere peculiar — add_^type > **01"b */ 


del 


1 


168_real_diskjptw aligned based (ptp) like 168jptwi 


/* 


PTW for page actually on disk ~ add_type •■ "10''b */ 


del 


1 


168_null_disk_ptw aligned based (ptp) like 168_ptwi 


/* 


PTW for page not yet on disk — add_type > "ll''b */ 


del 


1 


168_j»tw_£lags unaligned based. 


/* 


Various software/hardware flags */ 


(2 


add_type bit (4), 


/* 


0000-null, 1000-core, OlOOadisk, 0010-pd, OOOl-swap */ 




2 


first bit (1), 


/* 


the page has not yet been written out */ 




2 


er bit (1), 


/* 


error on last page I/O (also used by post-purge as temp) 




2 


padl bit (1), 








2 


unusablel bit (1), 


/* 


can't be used because hardware resets this bit */ 




2 


phu bit (1), 


/* 


page has been used bit */ 




2 


phml bit (1), 


/* 


Ctunulative OR of hardware phm's */ 




2 


nypd bit (1), 


/* 


must be moved to paging device */ 




2 


phffl bit (1), 


/* 


page has been modified bit */ 




2 


phul bit (1), 


/* 


page has been used in the quantum */ 




2 


wired bit (1), 


/* 


page is to remain in core */ 




2 


OS bit (1), 


/* 


page is out-of-servlce (I/O in progress) */ 




2 


valid bit (1), 


/* 


directed fault if this Is 0 (page not in core) */ 




2 


df_no bit (2)) unaligned! 


/* 


directed fault number for page faults */ 



/* END INCLUDE FILE ... ptw. 168. incl.pll */ 
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pv_holdn.lncl.pll aegment In: >ldd> Include contents modified: 05/20/76 0630.6 

entry modified: 06/21/85 1914.0 

/* BEGIN INCLUDE FILE ... pv_holdt.lncl.pll . . . */ 

del pv_holdCp ptri 

del 1 pv_holdt (1 : 64) baaed (pv_holdtp) aligned, 

2 pirtx fixed bln(17) unaligned, 
2 apterp blt(18) unallgnedi 

/* END INCLUDE FILE ... pv_holdt.lncl.pll ...*/ 
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pvt. Incl.pll 



segment ini >ldd> include contents modified] 05/27/82 1525.8 

entry modified: 06/21/85 1916.7 



/* BEGIN INCLUDE FILE ... pvt. incl.pll ... last modified January 1982 */ 



/* The physical volume table (PVT) is a wired-down table. 
It has one entry for each spindle present, be it for 
Storage System or "I/O" use. 

*/ 

del pvt$ ext, 
pvtp ptri 



1 pvt 


based (pvtp) aligned. 




2 


n_entries 


fixed bin (17), 


/* 


2 


max_n_entries 


fixed bin (17), 


/* 


2 


n_ln_u3e 


fixed bin (17), 


/* 


2 


rwunjpvtx 


fixed bin, 


1* 


2 


shutdown_s tate 


fixed bin. 


1* 


2 


esd state 


fixed bin. 


1* 


2 


prev_shutdown_state fixed bin, 


1* 


2 


prev_esd_state 


fixed bin. 


1* 


2 


t lme_of _bootload 


fixed bin (71), 


1* 


2 


root_lvld 


bit (36) aligned. 


1* 


2 


root_pvld 


bit (36) aligned. 


1* 


2 


root__pvtx 


fixed bin. 


1* 


2 


root_vtocx 


fixed bin, 


f* 


2 


dlsk_table_vtocx 


fixed bin. 


1* 


2 


dlsk_table_uid 


bit (36) aligned. 


1* 


2 


rpvs_requested 


bit (1) aligned, 


1* 


2 


rpv_needs_3alv 


bit (1) aligned. 


f* 


2 


rlv_needs_3alv 


bit (1) aligned. 


f* 


2 


volmap_lock_wait_ 


.constant bit (36) aligned. 


/* 


2 


volmap_ldle_walt_ 


_constant bit (36) aligned. 


1* 


2 


vtoc_map_lock_wait constant bit (36) aligned, 


2 


n_volmap_locks_held fixed bin (17), 


1* 


2 


n_vtoo_map_locks_ 


held fixed bin (17), 


1* 


2 


laat_volmap_t ime 


fixed bin (71), 


1* 


2 


last_vtoo_map_time fixed bin (71), 


1* 


2 


total_volmap_lock_time fixed bin (71), 


f* 


2 


total_vtoo_map_lock_time fixed bin (71), 


f* 


2 


n_volmap_locks 


fixed bin (35), 


f* 


2 


n_vtoc_map locks 


fixed bin (35), 


f* 


2 


volmap_lock_nowait_calls fixed bin (35), 


f* 


2 


volmap_lock_nowait_fails fixed bin (35), 


r* 


2 


volmap_lock_wait_calls fixed bin (35), 


f* 



niunber of PVT entries */ 
max number of PVT entries */ 
number of PVT entries in use */ 
rewind_unloading pvtx */ 
state of previous shutdown */ 
state of ESD, >0 iff in ESD */ 
shutdown state of previous bootload */ 
ESD state of previous bootload */ 

Time of bootload */ 

Logical volume ID of Root Logical Volume (RLV) */ 

Physical volume ID of Root Physical Volume (RFV) */ 

Index to PVTE for Root Physical Volume (RPV) */ 

VTOCE index for root (>) */ 

VTOCE index for dlak table on RPV */ 

File System UID for dlsk_table */ 

RPVS keyword given on B(X)T */ 

RPV required (not requested) salvage */ 

RLV required (not requested) salvage */ 

For constructing watt event: OR pvte_rel into lower */ 

For constructing wait event: OR pvte_rel into lower */ 

/* For constructing wait event: OR pvte_rel into lower */ 

Current number of volmap locks held */ 

Chirrent number of VTOC Map locks held */ 

Time a volmap was last locked/unlocked */ 
Time a VTOC Map was last locked/unlocked */ 
Total time volmap's were locked (integral) */ 
Total time VTOC Maps were locked (integral) */ 

Niunber times a volmap was locked */ 
Number times a vtoc_map was locked */ 
Number calls to lock volmap, no wait */ 
Number times lock failed */ 
Number calls to lock volmap, wait */ 
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2 volroap_lock_waLt_£aLLs fixed bin (35), /* Nvunber times lock failed */ 

2 pad (2) bit (36T aligned, 

2 arirajr fixed bin (71) i /* Array of PVTE's — must be double-word aligned */ 



/* END INCLUDE FILE . . .pvt. incl.pll */ 
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pvt«. Incl.pLl 



a«groent ins >Ldd>inolud« contents inodLfiedi 07/11/84 0937.3 

•ntry nodificdi 06/21/85 1919.1 



/* START OFs pvta.lnel.pLl July 1982 *****************/ 

/* Add«d pc_yacating, Benson MarguLles 84-10-17 */ 

del pvtSarray aligned external i 

doL pvt$max_n_entries fixed bin external i 



del pvt_arrayp 
del pvtep 

del 1 pvt_array 



ptri 
ptri 

(pvt$aiax_,n_entr iea ) 



aligned like pvte 



baaed (pvt_arrayp) i 



del 1 pvte based (pvtep) aligned, 

2 pvid bit (36), /* physical volume ID */ 

2 Ivld bit (36). /* logical voluaw ID */ 

2 d(npr_in_use (3) bit (1) unaligned, /* physical volume dun^er interlock */ 

2 pad3 bit (6) unaligned, 

2 skip_(iueue_count fixed bin (18) unsigned unaligned, /* number of times this pv skipped for per-proo allocation due to saturation */ 

2 brother_pvtx fixed bin (8) unaligned,/* next pvte in Iv chain */ 



2 


devname 


char ( 4 ) , 


/* 


device name */ 


(2 device type 


fixed bin (8), 


/* 


device type */ 


2 


logical area number fixed bin (8), 


/* 


disk drive number */ 


2 


used 


bit (1), 


/* 


TRUE if this entry is used */ 


2 


8torage_systero 


bit (1), 


/* 


TRUE for storage system (va io disk) */ 


2 


permanent 


bit (1), 


/* 


TRUE if cannot be demounted */ 


2 


testing 


bit (1), 


/* 


Protocol bit for read_disk$test */ 


2 


be ing_mounted 


bit (1), 


/* 


TRUE if the physical volume is being mounted *l 


2 


be ing_demounted 


bit (1), 


/* 


TRUE if the pysical voliime is being demovinted */ 


2 


check_r0ad_incom|>lete bit (1), 


/* 


page control should check read incomplete */ 


2 


device_inoperative bit (1), 


/* 


TRUE if disk_control decides dev busted */ 


2 


rpv 


bit (1), 


/* 


TRUE if this is the root physical volume */ 


2 


8cav_cheek_address 












bit (1), 


/* 


TRUE is page control should check deposits/withdrawals against scavenger table */ 


2 


depos it_to_volmap 


bit (1), 


/* 


TRUE if deposits should got to voltime map, not stock */ 


2 


be ing_demounted2 


bit (1), 


/* 


No more vtoc I/O during demount *l 


2 


pc_vacating 


bit (1), 


/* 


Mo more withdraws from this volume — for debugging */ 


2 


vacating 


bit (1), 


/* 


don't put new segs on this vol */ 


2 


hc_part_used 


bit (1). 


/* 


HC part set up by init_pvt */ 
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2 vo].aiap_Iock_notl£y bit (1) xmal, 
2 voliimp_idl«_notlfy bit (1) vinal , 
2 vt:oo_iMp_lock_notify bit (1) vinal. 



/* TRUE l£ notify required ^en volroap lock 1« unlocked */ 
/* TRUE if notify required when volmap atate la Idle */ 
/* TRUE If notify required when vtoo map lock la unlocked */ 



fixed bin (17), 
fixed bin (17), 

(2) bit (18), 

fixed bin (17), 



/* number of free VTOC entrlea */ 

/* alze of the VTOC part of the dlak - In recorda */ 
/* rel ptr to dumber bit mapa for thla volume */ 
/* number of recorda left */ 



fixed bin (17)) unallftnod, /* Total recorda In thla map */ 

bit (36), /* Information peculiar to DIM */ 

(3) fixed bin unaligned,/* current vtoox being dumped */ 
fixed bin unaligned, /* number of vtoce on thla volume */ 

fixed bin (18) una unaligned, /* Baae of paging region */ 

bit (18) unaligned. 



fixed bin (71), 



/* SDW deacirlblng volmap_aeg */ 



2 n_free_vtooe 
2 vtoc_alce 

2 dbrorp 

2 nleft 
2 totrec 

2 dlm_lnfo 

2 cum_dfflpr_vtocx 
2 n_^vtoca 

2 baaeadd 

2 pad2 

2 volmap_aeg_8dw 

2 volfflap_aatep 

2 voLmap_offaet 
2 vtoc_map_of f aet 

2 volmap^lock 
2 vtoc_map_lock 



2 volinap_async_state fixed bin (17) unaligned, /* Asynchronoua update atate of Voltime Map */ 
2 voimap_async_p8ge fixed bin (17) unaligned, /* Page number for asjmchronoua update */ 

2 voi_trouble_count fixed bin (17) unaligned, /* Count cf Inconslatenclea alnce laat aalvage */ 
2 acavenger__block_rel bit (18) unaligned! /* Offaet to aoavenger block, ^0 ■> aoavenglng */ 



unal 


» 


1* 


Packed pointer to ASTE for volmap^aeg 


(18) 


unal. 


1* 


Offaet in voImap_,aeg of volume map */ 


(18) 


unal, 


1* 


Offaet In volmap_aeg of VTOC map */ 


(36) 


aligned. 


1* 


Lock on volume oiap operatlona */ 


(36) 


aligned. 


1* 


Lock on VTOC map operatlona */ 


tuial^ 




1* 


Packed pointer to record atock */ 


unal; 




1* 


Packed pointer to VTOCE atock */ 



del (VOLMAP_ASYNC_IDLE 
VOLMAP„ASYNC_READ 
VOLMAP~ASYNC~WRITE 



Init (0), /* for volmap_aaync_atate */ 

tnlt (1), 

Inlt (2)) fixed bin Inl: atatlc optlona (conatant)i 



/* END 0F> 
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*/ 



*.* 
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scs.cd« aroh camp Ins >Ldd>hard>aourc«>boun<}_he_.d«ta_wired. a. archive 

component updated: 03/28/85 1031.9 



/ * ********************************************************** 

* * 

* Copyright, (C) Honeywell Information Systems Inc., 1984 * 

* * 

* Copyright (e) 1972 by Massachusetts Institute of * 

* Taclmology and Honeywell Information Systems, Inc. * 

* * 

** ******************************************************** * / 



/* SCS - The System Coomunications Segment 
modified 3/27/77 by Hoel I. Morris 

last modified 4/26/78 by J. A. Bush for processor testing 
Modified 2/79 by BSG for 8-cpu port expander 
Modified 9/16/80 by J. A. Bush for the DFS8/70H CPU 

Modified 1/09/81 W. Olin Sibert to remove all initial iiat ions to se«_and_clook_init 

Modified 01/16/81 W. Olin Sibert, to add scs$port_data ~ " 

Modified Jabuary 1981 by C. Homig for new I/O. 

Modified 2/22/81 by J. Bongiovanni for fast connect code 

Modified 4/23/81 by J. Bongiovanni for cyole_priority_teii9late 

Modified 4/09/82 by J. Bongiovanni for switch 0, processor_data_switch_value 

Modified 7/30/82 by J. Bongiovanni for troublej>rocessid 

Modified 4/11/83 by E. N. Kittlits for drljiiessage_pointer. 

Modified 10/25/83 by Keith Loepere for start of scs 

*/ 
sos: 

procedure i 
/* Static */ 

del «xclude_pad (1) char (32) static options (constant) init ("pad*")t 

/* Automatic */ 

del code fixed bin (35) i 

del 1 cdsa aligned like cds_argst 

del 1 fixed bint 

/* Builtins */ 

del Caddr, bin, bit, null, aise, string, unspec) builtini 
/* Entries */ 

del create_data_segment_ entry (ptr, fixed bin (35) )i 
Xpagis ; 

del 1 scs aligned, /* Information about system controllers */ 

2 start_of_sea fixed bin (71), 

2 controller_data (0:7) aligned like scs$eontroller_data. 



*.* 
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2 processor_data (Os7) aligned like sca^ 



/* per-controller Info */ 
/* Information about CPUs */ 
rocessor_data, 

* Information about CPUs in the aystem */ 

* Info on what is connected to each SCU port */ 

* Actual COW'S. */ 

* Rel pointers to COW's. */ 



2 port_data (0:7) like 8CS$port_data aligned, 
2 cow (0:7) like scs$cow, 

2 cowj>trs (0:7) aligned like 8Cs$cow_j>trs, 
2 reconf lg_general_cow aligned like scs$reconf ig_general_cow, 

f* Used for reconfiguration operations */ 



2 sy8_level aligned bit (72), 

2 open_level aligned bit (72), 

2 processor_start_mask aligned bit (72), 

2 cpu_test_mask aligned bit (72), 

2 number_of_masks fixed bin, 

2 procea8or__start_j>attem bit (36) aligned, 

2 cpu_te8t_pattem bit (36) aligned, 

2 expanded_po]:ts bit (1) unaligned dim (0:7), 

2 cam_pair fi»ed bin (71), 
2 cam_wait bit (8) aligned, 
2 pad! fixed bin, 

2 setjnaak (Ot7) bit (36) aligned, 
2 readjnask (0:7) bit (36) aligned, 
2 mask_ptr (On 7) ptr unaligned, 

2 ldle_aptep (0:7) ptr unaligned, 

2 connect_lock bit (36) aligned, 

2 reoonfig_lock bit (36) aligned, 

2 trouble_flajia bit (8) aligned, 

2 bos_restart_flaga bit (8) aligned, 

2 nproceasora fixed bin, 

2 bos_proce93cir_tag fixed bin (3), 

2 fault3_lnltlalized bit (1) aligned, 

2 sya_troubIe_jpending bit (1) aligned, 

2 fa3t_cam_pending (0:7) bit (36) aligned, 

2 interrupt_controller fixed bin (3), 

2 cycle_j>riority_template bit (7) aligned, 

2 set_cycle_3VTltche3 bit (1) aligned, 

2 proce3sor_start_int_no fixed bin (5), 

2 proceaaor bit (8) aligned, 

2 proce33or_3tart_wait bit (8) aligned, 

2 trouble_proce3sid bit (36) aligned, 

2 drl^me8aage_pointer ptr unal, 

2 proces8or_te8t_data aligned like 8C8$proces8or _te8t._< 
2 pad2 fixed bin, 

2 trouble_dbra (0!7) fixed bin (71), 
2 port_addresalng_word (0:7) bit (3) aligned, 
2 cfg_data (0:7) fixed bin (71), 
2 cfgjdata^save fixed bin (71), 
2 proces8or_switch_data (0:A) bit (36) aligned, 
2 proce8Sor_switch_template (0:4) bit (36) aligned, 
2 proces8or_switch_conipare (0:4) bit (36) aligned, 
2 processor_awitch_mask (0:4) bit (36) aligned, 
2 proce88or_data_8witch_value bit (36) aligned. 



MASKS and PATTERNS */ 

* mask used while handling I/O interrupts */ 

* mask used during normal operation */ 

* mask used when starting up a CPU */ 

* mask used for ISOLTS CPU tasting */ 

* number of masks (starting at sys_lev«I) */ 

* SMIC pattern used to send processor start Interrupt */ 

* SMIC pattern used for ISOLTS processor testing */ 

* Which ports have expanders */ 

* CAM and CACHE clear info */ 

* instructtona XEDd when CAMing and clearing C*ACHE */ 

* Used when evicting pagea from main memory */ 

* MASKING INSTRUCTIONS 6 POINTERS */ 

* inatructiona to set mask (STAQ or 8MCM) */ 

* inatructiona to read mask (LDAQ or RMCM) */ 

* pointers for real or simulated masks */ 

* MISCELLANEOUS */ 

* pointer to idle process APTE for each processor */ 

* lock for sending connects */ 

* lock used during reconfiguration */ 

* checkoff flags for sys_trouble stopping */ 

* checkoff flags for restarting after sys_trouble */ 

* number of proceasora online */ 

* CPU tag of proceaaor running BOS */ 

* ON after faults have been enabled */ 

* aya_trouble event la pending in the system */ 

* checkoff flags for cam connect */ 

* port number of low order controller */ 



interaotpt cell for starting a proceaaor */ 
bits ON for online CPUa */ 

checkoff flaga for waiting for new proceaaor */ 
processid cauaing crash */ 
pointer to DRL meaaage text */ 
ata, 

info for cpu teating */ 

DBR values at system craah time */ 

active module port number for each controller */ 

RSCR-CFG data from each controller */ 

RSCR-CF6 aave area for ISOLTS CPU teating */ 

actual procesaor RSW data */ 

expected data from RSW 0 thru 4 */ 

diacrepancies from expected data */ 

masks for coinparlng switch data */ 

Correct value of CPU data switches */ 



*.* 
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/* Data uaed by lnit_5St and collcct_free_core, from conflg cards. */ 
aligned,/* config card-stated size of controller */ 

I* process group ID of process doing reconfiguration */ 
/* Page table for SCiAS */ 
/* For initiallEaticin */ 

/* clear entire strticture */ 

/* Now set up for call to create_data_segment_ */ 

cdsa. sections (l).p ~ addr (sca)« 
cdsa. sections (l).len ■ sise (sc8)i 
cdsa. sections (1) .struct_naroe * "sos"! 



2 control ler_confLg_slze (0:7) fixed bin (lA) 
2 reconf lg_locker_ld char (32) aligned, 
2 scasjpage_table~(0:31) bit (36) aligned, 
2 end_of_scs fixed bini 

Xpage t 

unspec (scs) ■ "0"bt 



cdsa.seg_name <■ "scs"t 
cds8.nuiii_excLude_naines ■ li 
cdsa.exclude_array_ptr ■ addr (excludejpad) i 

string (cdsa. switches) " "0"bi 
cdsa. switches. have_text ■ "I'bi 

call create_data_8eginent_ (addr (cdsa), code)t 
return! 

Xpaga t 

X include scst 

X include eds_argst 



end SCSI 
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sdw.I68. LncL.pIl 



aegownt in: >lidd>includ« contents modified: 03/27/82 0429.8 

entry modlfiedt 06/21/85 1915.7 



/* BEGIN INCLUDE FILE ... sdw.16B.incl.pll ... Updated 
/* Notet This include file has an ALM counterpart made 

del 1 168_sdw based (sdwp) aligned, 

(2 add bit (24), 
2 rings, 

3 rl bit (3), 

3 r2 bit (3), 

3 r3 bit (3), 
2 valid bit (1), 
2 df_no bit (2), 

2 padl bit (1), 
2 bound bit (14), 
2 access, 

3 read bit (1), 

3 execute bit (1), 

3 write bit (1), 

3 privileged bit (1), 
2 unpaged bit (1), 
2 not_a_gate bit (1), 
2 cache bit (1), 

2 entry_bound bit (14)) unaligned! 
/* END INCLUDE FILE ... sdw.168.lncl.pll */ 



ilDP conversion 03/01/81 */ 
I oif . Keep it up to date */ 

/* Level 68 Segment Descriptor Word */ 

/* main memory address of page table */ 
/* ring brackets for the segment */ 



/* directed fault bit (0 -> fault) */ 
/* directed fault number */ 



/* boundary field (in 16 word blocks) */ 

/* access bits */ 

/* read permission bit *i 

I* execute permission bit */ 

/* write permission bit */ 

/* privileged bit */ 

/* segment is unpaged if this is 1 */ 

/* if this Is 0 the entry bound is checked by hardware */ 
/* cache enable bit */ 
/* entry bound */ 
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sst. IncL.pll 



aegment Ini >Idd>LncIuda contents modified: 01/30/85 1523.9 

entry modified: 06/21/85 1920.0 



/* BEGIN XNCLUDE FILE ... sst.lncl.pll ... January 1971 */ 

/* Note: Thla Include file has an ALM counterpart made with elf. Keep It up to date */ 
/* Deleted paging device Info and added pc segmove Info, Benson Margullas 84-01-03 */ 
/* Added covert channel meters, Keith Loepere 85-01-08. */ 

del sat_seg$ external i 
del sstp ptri 



del 1 sst based (sstp) aligned, 
2 space (8) fixed bin. 



/* empty space to watch for bugs */ 



/* SST HEADER */ 



2 pre_page_tlme fixed bin (71), 
2 po8t_purge_tlme fixed bin (71), 
2 post_ln_eore fixed bin, 
2 thrashing fixed bin, 
2 np£s_mlsses fixed bin, 
2 salv fixed bin, 

2 ptl bit (36), 

2 astl bit (36), 

2 sstl_event bit (36), 

2 astl_notlfy_requested bit (1) aligned, 

2 nuiied fixed bin, 

2 ptwbase fixed bin (24), 

2 tfreep ptr, 

2 sstap ptr, 

2 pt]l_walt_ct fixed bin, 
2 asnslse fixed bin, 
2 cmaslse fixed bin, 
2 ro<)t_astep ptr, 

2 pta (0: 3) fixed bin, 
2 level (0:3), 

3 (ausedp, no_aste) bit (18) unaligned, 

2: (atempp, atemppl) bit (18) unal, 
2 dm_enabled bit (1) aligned, 
2 (ainltp, ainltpl) bit (18) unal, 
2 strslse fixed bin. 



/* CORE liAP HEADER */ 



cmp ptr, 

usedp bit (18), 

vtct fixed bin. 



2 startp bit (18), 



* total time spent pre-paglng */ 

* total time spent post-purging */ 

* total pages in core (and In list) at purge time */ 

* meter of thrashing being done on system */ 

* oMter of times npfs was on iriien pre-paglng */ 

* flag lAlch Is ^"0 If and only If salvaging */ 

* global page table loop lock */ 

* global ast allocation block lock */ 

* event used when waiting for AST lock */ 

* flag to notify AST lock */ 

* number of pages on used list */ 

* absolute address of page table array */ 

* pointer to first trailer on free list */ 

* aste array pointer */ 

* pxsss number is >•■ # of processes waiting to ptl */ 

* size of an AST entry */ 

* size of a CMS entry *l 

* pointer to the root AST entry */ 

* array of page table sices */ 

* per-list information about ASTE's */ 

* used list and count of number of entries */ 

* teiq> seg list pointer */ 

* ON Journal seg exists */ 

* inlt seg list pointer */ 

* Trailer else in words. */ 



* pointer to start of core map */ 

* pointer to first used core block */ 

* covuit of pages being written */ 

* pointer to solid page for lap counting (fsdct) */ 
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2 removep bit (18), 



2 doubl«_wrlte fixed bin, 



2 teiiip_w_event bit (36) aligned, 
2 rootjpvtx fixed bin, 
2 nolock bit (1) aligned, 

2 fc_skips_pinn«d fixed bin (35), 

2 ol_sklpa_pinned fixed bin (35), 

2 a3t_ht_ptr ptr, 

2 aat_ht_n_buckets fixed bin, 

2 astjitjuidjnaak bit (36) aligned, 

2 meter_ast_locking fixed bin, 

2 check8uin_f ilemap fixed bin, 

2 page_read_errors fixed bin, 
2 page_write_errors fixed bin, 

2 oyclejpv_alloeation fixed bin, 

2 n_trailers fixed bin, 

2 synch_aetivations fixed bin (35), 

2 aynch_4kips fixed bin (35), 

2 lock_waita fixed bin, 
2 total_lock3_3et fixed bin, 
2 pdir_p&ge_fauLt3 fixed bin, 
2 level_l j»age_fault» fixed bin, 
2 dir_page_fault3 fixed bin, 
2 ring_0_page_faults fixed bin, 
2 rqover fixed bin (35), 
2 pc_lo_waits fixed bin. 



t* The following (until pdmap) used to be 

2 3tep3 fixed bin, 
2 needc fixed bin, 
2 ceiling fixed bin, 
2 ctwait fixed bin, 
2 wired fixed bin, 
2 laps fixed bin, 
2 akipw fixed bin, 
2 akipu fixed bin, 

2 3kipm fixed bin, 

2 skipos fixed bin, 

2 aused fixed bin, 

2 dainaged_ct fixed bin, 

2 deact_covint fixed bin, 

2 demand_deact_attempts fixed bin, 

2 demand_de activations fixed bin. 



/ik pointer to list of pages being removed from use */ 
/* MISC */ 

/* trigger for store through schema */ 
/* 0 a no double writes, 

1 - all non-pd pages get written, 

2 - all directories gat written */ 
wait event for temp wiring lock */ 

/* pvtx or rpv */ 

if on, don't lock ptl on interrupts */ 

/* number of skips over pinned page in find_core */ 

f* number of skips over pinned page in elaimjnod_core */ 

/* AST hast table pointer */ 

number of buckets in AST hash table */ 
/* mask to strip out low-order bits of uid */ 
/* non-zero enables AST lock meters */ 
I* non-zero enables f ilemap checksumming */ 

/* read errors posted to page control */ 
/* write errors posted to page control */ 

/* flag to cycle VTOCE allocation among PVs */ 

/'* Number of trailer entries in str_seg */ 
/* Activation attempts for synchronized segs */ 
get_aste skips because not synchronized */ 

/* Number of times we had to wait for a lock */ 

/* Total number of block locks set '"'/ 

J* total page faults off >pdd */ 

/* total page faults in ays libes */ 

/* Total page faults on directories */ 

/* page faults in ring 0 */ 

/* errcode for record quota overflow */ 

/* Number of times pc had to wait on io */ 



'cnt' in cnt.lncl.pll */ 



/* 


ntunber 


of 


steps 


taken around used list */ 


/* 


number 


of 


times 


core page needed */ 


/* 


number 


of 


times 


celling hit */ 


/* 


nvimber 


of 


times 


write counter was full */ 


/* 


number 


of 


pages 


wired by pc */ 


/* 


number 


of 


times 


around used list */ 


/* 


number 


of 


pages 


sklped because they were wired */ 


/* 


because of being used */ 



/* because of being modified */ 

/* because out of service */ 

/* number of AST entries on used list */ 

/* count of segments that system damaged */ 

/* covtnt of deactivations */ 

/* user requested deactivations */ 

/* user instigated deactivations */ 
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2 resda (8) fixed bin, 
2 writes (8) fixed bin, 

2 short_pf_count fixed bin, 

2 loop_locks fixed bin, 

2 Ioop_lock_tiim fixed bin (71), 

2 cpu_sf_tiiiie fixed bin (71), 

2 totaL_sf_pf fixed bin, 

2 total_sf fixed bin, 

2 pr«:jpage_siBe fixed bin, 

2 poat_Iist_eise fixed bin, 

2 poat_purglngs fixed bin, 

2 poat_purge_oalL8 fixed bin, 

2 pce_page_calla fixed bin, 

2 pre_page_llat_sice fixed bin, 

2 prejpage_ffliases fixed bin, 

2 pc«_paglngs fixed bin, 

/* TEMPORARY HIRED PROCEDURE INFO */ 

2 wlrejproc_data (8) fixed bin (71), 

/* MAIN MEMORY USA6E INFORMATION */ 

2 abs_wired_count fixed bin, 
2 systeiii_type fixed bin, 
2 wired_copies fixed bin, 
2 recoplea fixed bin, 
2 f irst_core_bIock fixed bin, 
2 Iast_core_block fixed bin, 
2 fw_retriea fixed bin (35), 
2 pvhtp ptc unaligned, 

/* AST METERS */ 

2 askipsize (Oi 3) fixed bin, 
2 aneedsiee (Oi 3) fixed bin, 

2 istepaa fixed bin, 
2 aaklpaeha fixed bin, 
2 aaciarchea fixed bin, 
2 aaklpalevel fixed bin, 
2 aaklpalnlt fixed bin, 
2 acoat fixed bin, 
2 aaklpalock fixed bin, 
2 aaklpdlus fixed bin, 

2 alaps fixed bin, 

2 updates fixed bin, 

2 setfaults_all fixed bin, 

2 aetfaults_acc fixed bin, 

2 total_bf fixed bin, 

2 total_bf_pf fixed bin, 

2 cpu_bf_tlme fixed bin (71), 



/* number of reads for each did */ 
/* number of writes for each did */ 

/* count of page faults on out of service pages */ 

/* count of times locked PTL */ 

/* time spent Looping on PTL */ 

/* epu time spent in seg_fauLt */ 

/* total page faults i^ila in seg_fault */ 

/* total number of seg_faults */ 

/* total pre-pagings expected */ 

/* total number of post-purgings */ 

/* total number of calls to post-purge */ 

/* total number of calls tp pre-page */ 

/* total number of misses in pre-page list */ 
/* total number of pre-pagings */ 



/* data for wirejiroe */ 



/* count of abs -wired pages */ 
/* ADP^SYSTEM or L68_SYSTEH */ 
/* number of times a wired page was copied */ 
/* number of times recopied because modified */ 
/* core map index for first block of core */ 
/* core map index for last block of core */ 
/* force_write retries due to ASTE move */ 
/* ptr to PV hold table for debugging */ 



/* array of skips because wrong AST sise */ 
/* array of times needed each sise */ 

/* count of steps taken looking for an AST entry */ 

/* count of skips because EHS was ON */ 

/* count of full searches made */ 

/* count of sklpa because pages were in core */ 

/* covint of times turned OFF init switch */ 

/* cumulative coat of deactlvatlona */ 

/* count of skips because couldn't lock parent */ 

/* count of sklpa because DIUS was on */ 

/* lap counter for AST list */ 

/* calls to updateb */ 

/* setfaults done to the entire SOU */ 

/* setfaults done to the access field */ 

/* count of bound faults *l 

I* page faulta during bound faults */ 

/* cpu time spent in bound fault */ 
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2 Asteps (Oi 3) fixed bin, 

2 •at_lock«d_at..tiine fixed bin (71), 
2 a8t_locfc«d_tol:al_tim« fixed bin (71), 
2 •9t_Lock_wait_time fixed bin (71), 
2 a8t_locking_count fixed bin (35), 
2 cleanup_count fixed bin, 
2 eleanup_reaL_tiiiie fixed bin (71), 

/* PRE-PA6E METERS */ 

2 tree_count (Ot 63) fixed bin, 

2 ppjnetere (Oi 63) fixed bin, 



2 wusedp bit (18) aligned, 

2 write_hunts fixed bin, 

2 claim_skip_<sm« fixed bin, 

2 claim_skip_fr«e fixed bin, 

2 claiin_notrood fixed bin, 

2 claim_passed_used fixed bin, 

2 cIaiin_akip_ptvT fixed bin, 

2 claiin_writes fixed bin, 

2 claiin_8teps fixed bin, 

2 pre_seeks_failed fixed bin, 

2 resurrections fixed bin, 

2 volnuip_seg_pag;e_fauLts fixed bin (33), 

2 oopv fixed bin, 

2 dbIw_resurrections fixed bin, 

2 sgm_tiine fixed bin (71), 

2 sgin_pf fixed bin, 

2 bad_sgins fixed bin, 

2 sgin_sgft fixed bin, 

2 good_sgms fixed bin, 

2 clairo_runs fixed bin, 

2 activations fixed bin, 

2 dir_activations fixed bin, 

2 hedge_updateva fixed bin, 

2 hedge_writes fixed bin, 

2 evict_recover_,data, 

3 evict_ptp bit (18) imal, 

3 evict_phmbit bit (18) unal, 

/* Data for metering foreejwrite facility 08/19/78 */ 

2 foroe_8write« fixed bin, 
2 foree_pwritea fixed bin, 
2 fw_none fixed bin, 
2 foroejupdatevs fixed bin, 

2 pf_unlock_j»tl_tiine fixed bin (71), 
2 pf_unlock_ptl_meteringa fixed bin, 

2 makeknown_activation8 fixed bin (35), 
2 baekup_activations fixed bin (35), 



/* per-siae AST step eotmters */ 

/* clock reading when ast last locked */ 

/* total real time the ast look was looked */ 

/* total real time of all waiting on ast lock */ 

/* number of times ast was locked */ 

/* calls to pc$oleanup */ 

/* total real time in po$cleanup */ 



/* counters for pre-page deoisions */ 

/* counters for measuring pre-page success */ 



/* Relative cmep to next cme for writing */ 

/* Times claiffljnod__core invoked */ 

/* Times unacceptable ome found by o_m_c */ 

/* Times free cme passed by ojn_o */ 

/* Times cjai_c passed pure page */ 

/* Times used page seen */ 

/* Times c_m_c saw unacceptable ptw */ 

/* Writes queued by cjn_c */ 

/* Steps passed in core claiming */ 

/* counter of times quick find_core_ failed */ 

/* nulled addresses reinstated */ 

/* Pseudo-page faults on volmap_seg */ 

/* out-of-physioal -volume page faults */ 

/* addresses resurrected by double-writing */ 

/* Time (VCPU) in seg mover */ 

/* Page faults in seg moving */ 

/* Seg moves that failed */ 

/* Seg faults in seg moves */ 

/* Seg moves that completed */ 

/* Times claim_mod_core had to run */ 

/* total count of activations */ 

/* count of directory activations */ 

/* call-in updatevs */ 

/* call in core flush writes */ 

/* see evict_page . aim */ 

/* ptp of page being moved */ 

/* N/Z if page was mod */ 



/* Calls on segments to force write */ 
/* Mod pages so written */ 
/* Force write wrote none */ 
/* Updatev's so forced */ 

/* Time unlocking ptln page faults */ 



/* activations at makeknown time */ 
/* activations for backup */ 
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2, meter lng_fl«ga aligned, 

3 nctLvate_»otivated bit (1) iinal, 

3 pad bit 735) unal, 
2 seB_£auLt_oalls fixed bin (35), 



/* aroall cliunke of niac. information */ 
/* ON •■> last oall to activate entry actually activated something */ 

/* number calls to seg^fault for explicit activation */ 



/* METERS FOR STACK TRUNCATION */ 



2 (stk_truneate_should_didnt, /* counts */ 

stk_trunoatc_should_did , 

stk_truncate_shouldnt_didnt , 

snk_truneate_shouldnt_did) fixed bin (35), 
2 stk_pages_truncated fixed bin (35), 
2 stk_pages_truncated_in_core fixed bin (35), 

/* SUPPORT FOR PC SEGMOVES */ 



2 segmove_lock aligned, 

3 pid bit (36) aligned, 

3 event bit (36) aligned, 

3 notify bit (1) aligned, 
2 segmove_io_llmit fixed bin, /* max read aheads */ 
2 aegmove_found_synch fixed bin (35), /* cme . syneh_held */ 
2 se8move_synch_disappeared fixed bin (35), /* page$cheek_syneh fixed */ 
2 segmove_n_reads fixed bin (35), /* total lO's queued. */ 
2 segmove_max_tries fixed bin (35), /* max times through the read loop */ 



2 seamove_astep ptr unal, 

2 segmovejpvtx fixed bin, 

2 segmove_vtocx fixed bin, 

2 segmove_old_addr_a3tep ptr unaligned, 

2. se(;move_nev_addr_astep ptr unaligned. 



/* if non-null, addresses to be rescued from old_addr_,astep */ 
/* if segmove_astep nonnull, Valid */ 
/* ditto */ 
/* ditto */ 

/* if non-null, the addresses must be deposited. */ 



mod_during_write fixed bin, 
serojpages fixed bin, 
trnce_sw aligned, 
3 pad_trace bit (32) unaligned, 
3 pc_trace_j>f bit (1) unaligned, 
3 l:ty_trace bit (1) unaligned, 
3 pc_trace bit (1) unaligned, 
3 ac_trace bit (1) unaligned, 
new_pages fixed bin, 
asl:_track bit (1) aligned, 
dii:lock_writebehind fixed bin, 
wrlte_llrait fixed bin, 
cr»sh_test_segmove bit (1) aligned, 
deLayed_seg_state_chg fixed bin (35), 
audlt_seg_state_chg fixed bin (35), 
se«_state_chg_delay fixed bin (52), 
sei(_state_change_limit fixed bin, 
ffiia»_seg_state_ch8nge_bw fixed bin, 
audit_aeg_atate_ch8nge_bw fixed bin, 
seg_atate_chg_opcration bit (36) aligned, 
pa(14 (126) bit (36) aligned} 



/* times a page was modified while it was being written */ 
/* count of pages tiimcated because all sero */ 
/* tracing control flags */ 



/* tracing for page faults, done, etc. 



*/ 



/* flag used by page control primitives */ 
/* flag used by segnient control primitives */ 
/* nevly created pag,es */ 
/* "l^b -> keep SST name table */ 

/* "1 to flush modified dir pages in lock$unlock */ 
/* Max # of outstanding writes by page control */ 
/* crash in mld-aegniove */ 

/* count of times a proceaa was delayed in affecting a seg state */ 

/* count of times a process was audited for excessive seg state changes *l 

I* total times processes were delayed for covert channels *! 

I* number of events over which we determine covert channel bandwidth */ 

/* maximum bps for covert channel before we delay *l 

I* maximum bps for covert channel before we audit */ 

/* access_operation_, value for excess iv«_seg_state__ehg */ 

/* padding to 512 words (1000)8 */ 



/* END IHCLUDE FILE sst.incl.pll */ 
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aatnt.incl.pll 



segment Int >ldd>inolude contenta modlfledt 11/02/84 0912.2 

entry inodlfieds 06/21/85 1919.3 



/* Begin Include file aatnt.incl.pll */ 
/* Created 10/03/74 by Bernard Greenberg */ 

/* modified 08/24/79 by J. A. Buah for eaaier calculation of aise of aatnt */ 
/* Modified 08/27/84 by Keith Loepere to purge BOS */ 



del 8at_n«roea_$ exti 
del aatnp ptri 

del 1 aatnt baaed (aatnp) aligned, 
2 valid bit (1) aligned, 
2 multica_or_bce char (4) aligned, 
2 nentriea fixed bin, 
2 padl (5) fixed bin. 



2 (aat_aizea, 
aat_n«me_of f aeta , 
aat_offaeta, 

padi) (0 t 3) fixed bin, 



/* Segment containing ast name table */ 

/* Pointer to ast name segment */ 

/* Major structure */ 

/* 1 «> structure filled by Multica */ 

/* Origin of data in table */ 

/* number of entries in the sstnt */ 



/* Sizes of ASIE's at each level */ 

/* Starting index for names at each level */ 

/* Starting rel addr of each AST region */ 



2 namaa (0 t 0 refer (aatnt. nentriea)) char (32) varyirtgi; /* Hames of AST entries */ 
del (aatnmx, ptai_a) fixed bin (17) i /* Index into name table */ 

del tuD_aatep ptri /* aatep to be uaed */ 



/* End include file aatnt.incl.pll */ 



*,* 
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B tack^O^data . incl . pi 1 



segment in: >Idd>inol\ide contents modified: 10/25/79 0712.2 

entry modified: 06/21/85 1914.7 



/* BEGIN INCLUDE FILE ... stack_0_data.incL.pIl */ 
/* Created 790509 by Mike Grady */ 



del 8tac.k_0_data$ fixed bin exti /* shared stack 0 data base seg */ 

del stack_0_data_init_number_of_stacks fixed bint /* Make PL/I work */ 

del sdtp ptri 



del 1 sdt aligned based (sdtp), 
2 lock bit (36), 
2 num_8tacks fixed bin, 
2 freep bit (18), 
2 pad fixed bin, 

2 stacks (staek_0_data_init_number_of_stacks 
refer (sdt.nuffl_stacks)) like sdtei 



/* stack 0 database */ 

/* lock before changing threads */ 

/* number of stacks in pool */ 

/* head of free thread, managed LIFO */ 



del sdtep ptrt 



del 1 sdte aligned based (sdtep), 
2 nextp bit (18) unal, 
2 pad bit (18) unal, 
2 astep bit (18) tinal, 
2 aptep bit (18) unal, 
2 sdw bit (72)1 



/* stack data table entry */ 

/* thread to next free entry (if free) */ 

/* ptr to ASTE for this stack seg */ 

/* ptr to APIE of process using this stack, if not free */ 
/* SDW for this stack seg */ 



/* END INCLUDE FILE ... 8tack_0_data.incl.pll */ 



*.* 
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stack_f rame . Incl .pll 



aegment in: >l(ld>include contents modlfledt 12/0A/84 2012.2 

entry modified: 06/21/85 1919. A 



/* 



BEGIN INCLUDE FILE 



9tack_f rame . Inol .pll 



*/ 



/* Modlfledt 16 Dec 1977, 0. Levin - to add flo_ps_ptr and pll_p8jptr */ 

/* Modified! 3 Feb 1978, P. Krupp - to add rtmjinltjnanagur bit & malnjproc bit */ 

/* Modified: 21 March 1978, D'. Levin - change flo_ps_ptr to iiupportjptr */ 

/* Modified: 03/01/84, S. Berbst - Added RETUBN_PTR_MASK */ 



del RETURN_PTR_MASK bit (72) Int static options (constant) 
lnlt~('*777777777777777777000000"b3)i 



/* say: unspeo(ptr) 



/* mask to be AND'd with staek_f rame . retuxn_ptr */ 
/* when copying, to Ignore bits that a call fills */ 
/* with Indicators (nonsero for Fortran hexfp caller) */ 
unspeo(stack_fraiiie.retunij>tr) & RETUItN_PTRJlASKi */ 



del ap pointer i 

dol stack_fxaimjnln_length fixed bin static lnit(48)t 



/* pointer to beginning of stack frame */ 



del 1 stack_frame based(sp) aligned, 
2 pointer_registers(0 : 7) ptr, 
2 prev_sp pointer, 
2 next_ap pointer, 
2 retum_ptr pointer, 
2 entry_ptr pointer, 
2 operator_and_lp_ptr ptr, 
2 argjptr pointer, 
2 static_ptr ptr unaligned, 

2 aupportjptr ptr unal, /* only used by fortran I/O */ 
2 on_unit_reLpl bit(18) vmaligned, 
2 on_unit_relp2 bit(18) unaligned, 
2 translator_ld blt(18) unaligned. 



2 operator__retum_offset bit(18) unaligned, 
2 x(0: 7) bit(18) vmaligned, 
2 a bit(36), 
2 q bit(36), 
2 e blt(36), 

2 timer bit (27) unaligned, 

2 pad blt(6) unaligned, 

2 ring_8larm_reg bit (3) unaligned) 



/* serves as both */ 



/* Translator ID 

0 »> PL/I version II 

1 -> ALM 

2 >> PL /I version I 

3 >> signal caller frame 

4 ■>> signaller frame *l 

I* index registers */ 
/* accumulator */ 
/* q-reglster */ 
/* exponent */ 

/* timer */ 



del 1 stack_frame_flaga based(sp) aligned, 
2 padCo""! 7) bit(72), 
2 xxO bit(22) unal, 
2 main_proc blt(l) unal, 



/* skip over prs */ 

/* on if frame belongs to a main procedure */ 
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2 run_unit_iDanager bit(l) imal, 

Z algnal blt(l) una!, 

2 crawI_out bit(l) unal, 

2 slsnallcr bit(l) unal, 

2 LLnk_trap blt(l) unaL, 

2 support blt(l) unal, . 

2 condition blt(l) unal, 

2 xxOa bit (6) unal, 

2 xxl fixed bin, 

2 xx2 fixed bin, 

2 xx3 blt(25) unal, 

2 old_crawl_out bit (1) unal, 

2 old_8lgnaller blt(l) unal, 

2 xx3a blt(9) unaligned, 

2 xx4(9) blt(72) aligned, 

2 v2_j»ll__op_ret_baae ptr. 



2 xx;5 bit (72) aligned, 
2 plljpajptr ptr I 

/* END INCLUDE FILE ... staok_frajne.lnol.pll */ 



/* on If frame belonsa to run unit manager */ 

/* on If frame belongs to logical signal^ */ 

/* on If this Is a signal caller frame */ 

/* on If next frame Is signaller's */ 

/* on If this frame was made by the linker */ 

/* on If frame belongs to a support proc */ 

/* on If condition established In this frame */ 



/* on If this is a signal caller frame */ 
/* on If next frame Is signaller's */ 



/* When a V2 PL/I program calls an operator the 

* operator puts a pointer to the base of 

* the calling procedure here, (text base ptr) */ 

/* ptr to ps for this frame i also used by flo. */ 



*.* 
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atack_header . IncL . pll 



segment Ins >I<ld>lncli)de contents modified: 08/24/83 1646.6 

entry modified? 06/21/85 1917.5 



/* 
/* 
/* 
/* 

/* format 
del 

del 



BEGIN INCLUDE FILE ... 8tack_header.lncl.pll .. 3/72 Bill Silver */ 
modified 7/76 by H. Weaver for ^system links and more system use of areas */ 
modified 3/77 by M. Weaver to add mt_ptr */ 

Modified April 1983 by C. Homig for tasking, (the trace stuff is teinporary - 
t style2 */ 



NBW) */ 



b 




ptri 


/* 


the 1 


main pointer to the stack header */ 


stack header 


based (sb) aligned, 










2 


padl 


(4) fixed bin. 


/* 


(0) 


also used 


as arg List by outward_caLl_handler */ 


2 


old_lot_ptr 


ptr, 


/* 


(4) 


pointer to the lot for current ring (obsolete) */ 


2 


comb lned__stat_j>tr 


ptr. 


/* 


(6) 


pointer to area containing separate static */ 


2 


clrjptr 




/* 


(8) 


pointer to area containing linkage aections */ 


2 


fflax_lot_size 


fixed bin (17) unal. 


/* 


(10) 


DU number of words allowed in lot */ 


2 


main_j>roc_invoked 


fixed bin (11) unal. 


/* 


(10) 


DL nonzero if main procedure invoked in run unit */ 


2 


have_statlc_vlfta 


bit (1) unal, 


/* 


(10) 


DL "l"b 


if (very) large arrays are being used in static 


2 


pad4 


bit (2) unal. 










2 


run_unlt_depth 


fixed bin (2) unal. 


/* 


(10) 


DL number of active run units stacked */ 


2 


cuir_lot_sise 


fixed bin (17) unal. 


/* 


(11) 


number of words (entries) in lot */ 


2 


pad2 


bit (18) unal. 


/* 


(11) 


reserved */ 


2 


systera_free_ptr 


ptr. 


/* 


(12) 


pointer to ayatem atorage area */ 


2 


U8er_f reejptr 


ptr, 


/* 


(14) 


pointer to uaer atorage area */ 


2 


null_ptr 


ptr, 


/* 


(16) 


*/ 




2 


s tack_beg Lnjptr 


ptr. 


/* 


(18) 


pointer to firat stack frame on the atack */ 


2 


a tack_end__ptr 


ptr, 


/* 


(20) 


pointer 


to next useable atack frame */ 


2 


lot_ptr 


ptr, 


/* 


(22) 


pointer to the lot for the current ring */ 


2 


signal__ptr 


ptr. 


/* 


<2A) 


pointer to signal procedure for current ring */ 


2 


bar_mode_sp 


ptr, 


,f* 


(26) 


value of ap before entering bar mode */ 


2 


pll_operatorajptr 


ptr. 


/* 


(28) 


pointer 


to pll_operatora_$operator_table */ 


2 


call_opjptr 


ptr, 


/* 


(30) 


pointer 


to atandard call operator */ 


2 


push_op_ptr 


ptr, 


/* 


(32) 


pointer 


to atatulard push operator */ 


2 


retum_op_ptr 


ptr. 


/* 


(34) 


pointer 


to standard return operator */ 


2 


return_no_pop_opjptr 














ptr, 


/* 


(36) 


pointer 


to standard return / no pop operator */ 


2 


entry_op_ptr 


ptr. 


/* 


(38) 


pointer 


to atandard entry operator */ 


2 


t rans_op_tvjpt r 


ptr, 


/* 


(40) 


pointer 


to translator operator ptra */ 


2 


iaotjptr 


ptr. 


/'* 


(42) 


pointer 


to ISOT */ 


2 


act_jptr 


ptr. 


/* 


(44) 


pointer 


to Syatem Condition Table */ 


2 


vinwinder_ptr 


ptr. 


/* 


(46) 


pointer 


to unwinder for current ring */ 


2 


sys_l lnk_lnf o_ptr 


ptr. 


/* 


(48) 


pointer 


to *3ystem link name table */ 


2 


mt_ptr 


ptr. 


/* 


(50) 


pointer 


to Reference Name Table */ 


2 


eot_ptr 


ptr. 


/* 


(52) 


pointer 


to event channel table */ 


2 


aa a ign_l inkage_pt r 


ptr. 


/* 


(54) 


pointer 


to storage for (obsolete) hcs_$assign_linkaga */ 


2 


ta8k_datajptr 


ptr. 


/* 


(56) 


for possible tasking (experimental) */ 


2 


trace , 




/* 




expected to be temporary */ 




3 frames. 














4 count 


fixed bin. 


/* 


(58) 


number of trace frames */ 




4 top_ptr 


ptr unal. 


/* 


(59) 


pointer to last trace frame */ 




3 in_trace 


bit (36) aligned. 


/* 


(60) 


trace antixecursion flag */ 


2 


pad3 


(3) bit (36) aligned! 


/* 


(61) 


for future expansion */ 
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I* Tha following offset refars to a tab!* within the pll operator table. */ 



del 



tv offset 



fixed bin init (361) internal statici 

/* (551) octal */ 



The following constants are offsets within this transfer vector table. */ 



del ( 

call_offset 

push^offset 

retum_offset 

retunv_noj>op_offset 

entry_offset 

) 



fixed bin init (271), 
fixed bin init (272), 
fixed bin init (273), 
fixed bin init (274), 
fixed bin init (275) 
internal s tat lot 



*/ 



The following declaration is an overlay of tha whole stack header. Procedures which 
move the whole stack header should use this overlay. 



del 8tack_headar_ovarlay (size (stack_he8d«r)) fixed bin based (ab)i 



/* 



END INCLUDE FILE ... stack_header. incl .pll */ 
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8tr.lncl.pll 



sagment Ini >ldd>lnclude contents modified: 05/06/74 1751.6 

entry modified: 06/21/85 1914.1 



/* BE6IH INCLUDE FILE ... str.lncl.pll ... last modified March 1970 */ 



del str_8eg$ ext, 
strp ptri 

del 1 str based (strp) aligned, 

(2 fp bit (18), 
2 bp bit (18), 

2 segno bit (18), 

2 dstep bit (18)) unaligned i 

del stra (0:8000) bit (72) based (strp) alignedi 

/* END INCLUDE FILE ... str.lncl.pll */ 



/* segment or process trailer declaration */ 

/* forward ast trailer rel pointer */ 
/* backward ast trailer rel pointer*/ 

/* segment number*/ 

/* rel pointer to ring 0 dste */ 
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tcm.JlncL.pll 



segment ini >Ldd>inclvKl« contenta modlfiedi 01/30/85 1523.9 

•ntxy modlfiedi 06/21/85 1920.0 



/* BliGIN INCLUDE FILE ... tcm.inoI.pLl ... used to generate tc_dat» eda */ 

/* NOTE — This include file has TWO counterparts in ALMi tojneters . incl . aim and */ 

/* wcte. incl. aim. Thejr cannot be produced with eif, and must be kept up to date manually. */ 

/* Modified 830914 to replace tty_polling_time with opc_polling_time. . . -E. A. Ranzenbach */ 

/* Modified 1984.05.21 by M. Pandolf to add te_suspend_lock */ ~ 

/* Modified 1984.11.26 by Keith Loepere for uid_array.~*/ 

/* Modified 1984.12.06 by Keith Loepere for page create delaying. */ 

del tenK> ptri 









4m suspond Loclc iLllctt lock^ 


/* 


when locked, tc is suspended ^/ 


2 eid2 fixed'bin (18), 






2 cld3 fixed bin (18). 






2 cid4 fixed bin (18), 






2 depth count fixed bin (18), 


/* 


depth last process run ^/ 


9 loftdinas fixed bin f 18) . 


/* 


mjnbAi? of nifoAAMJii lAndf^nsfl e/ 


9 blioakfl fixed bin tlBS 


/* 


numhAif aaHa ^'a li'LAelc e/ 


2 wakeups fixed bin (18), 


/* 


number of calls to wakeup */ 


2 waits fixed bin (18), 


/* 


number of calls to wait */ 


2 notifies fixed bin (18), 


/* 


number of calls to notify */ 


2 achedullngs fixed bin (18), 






2 interactions fixed bin (18), 


/* 


number of interactive schedulings *l 


2 avequeue fixed bin (35, 18), 


/* 


recent time average of number in queue */ 


2 te wait fixed bin (18), 


/* 


times te called from wait */ 


Z te block fixed bin (18), 


/* 


times te updated from block ^/ 


2 te 1 stop fixed bin (18), 


t* 


times te updated from i stop ^/ 


2 te pre empt fixed bin (18), 


1* 


times te updated from pre_empt */ 


2 p_Lnteractions fixed bin. 


1* 


times interaction bit turned off because of high priority */ 


2 Idle fixed bin (71), 


1* 


total idle time *l 


2 nip._idle fixed bin (71), 


1* 


multi-programming; idle */ 


2 nin]p_idle fixed bin (71), 


1* 


non-multi-progranming idle time */ 


2 zero_idle fixed bin (71), 


1* 


zero idle time */ 


2 lait'time fixed bin (71), 


1* 


last time a process was run. */ 


2 loop_locks fixed bin (18), 


1* 


times looped on the APT lock */ 


2 Ioop_lock_tinie fixed bin (18), 


1* 


time looping on the APT lock */ 


2 av«_eligible fixed bin (35, 18), 


1* 


average length of eligible queue */ 


2 3ort_to_elhead fixed bin (18), 


t* 


0-> no one,l •■> Int've only, 2 -> everybody */ 


2 processor_time fixed bin (71), 


1* 


total processor time on system */ 


2 response^time fixed bin (71), 


1* 


estimate of response time *l 


2 eligible'time fixed bin (71), 


/* 


estimate of eligible time *l 


2 responae_count fixed bin, 


/* 


count of response meters */ 


2 elLgibLe_count fixed bin, 


1* 


count of eligible meters *l 


2 quLt_counts (0:5) fixed bin. 


1* 


array of buckets indexed by state */ 


2 lo.adlng_idle fixed bin (71), 


1* 


loading_idle time */ 


2 deLta_vcpu fixed bin (71), 


1* 


delta virtual CPUl time for the system */ 


2 pojt_purge_switch fixed bin. 


/* 


ON if post purging is to be done */ 



*.* 
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2 tlme_out_sevei:Lty fixed bin, 

2 notlfy_check fixed bin, 

2 quit^prlority fixed bin, 

2 iobnij>olIing_t:iiiM fixed bin (71), 

2 end_of_tiine fixed bin (71), 

2 gp_at_notify fixed bin (18), 

2 gp_at_j>tlnotify fixed bin (18), 

2 int_q_enabled fixed bin (18), 

2 fi:q>_buffer_thre8hoLd fixed bin (18), 



/* 100 octal */ 

2 depths (8) fixed bin (18), 
2 tdepths (8) fixed bin (71), 
2 pf depth (8) fixed bin (18), 

2 ptl_not_wait8 fixed bin (18), 

2 gw__gp_window_coimt fixed bin (18), 

2 metering_loek fixed bin (18), 

2 ptL_waits fixed bin (18), 

2 gp_atart_count fixed bin (18), 

2 gp_done_count fixed bin (18), 

2 nto_check_time fixed bin (71), 

2 nto_delta fixed bin (35), 

2 nto_covtnt fixed bin (18), 

2 tcpu_scheduling fixed bin (18), 

2 nto_event bit (36), 

2 page_notif les fixed bin (18), 

2 not l£y_nobody_ count fixed bin (18), 

2 notlfy_nobody_event bit (36), 

2 system_type fixed bin, 

2 Stat (0:15) fixed bin (18), 

/* 200 octal */ 

2 wait (8), 

3 time fixed bin (18), 
3 count fixed bin (18), 

2 ready (8), 

3 time fixed bin (18), 
3 count fixed bin (18), 

2 total_pf_tlme fixed bin (71), 

2 totaI_pf_count fixed bin (18), 

2 auto_tune_vs fixed bin (18), 

2 ocore_deLta fixed bin (18), 

2 ws^sum fixed bin (18), 

2 nonldle_force_count fixed bin (18), 

2 itt_list_lock bit (36) aligned, 

2 cpu_pf_time fixed bin (71), 

2 cpu_pf_count fixed bin (18), 

2 special,_offsets unaligned. 



*.* 



/* syserr first arg for notify time outs */ 
/* obsolete */ 

/* factor for scheduler quit response */ 

/* time to poll iobm */ 

/* very large tioie */ 

/* 0 ■>> Just do get_idle_processor */ 

/* 0 -> Just do get_idle_|»roc«ssor */ 

f* 0 -> no intv 4 in percent mode */ 

/* if fewer free buffs then stingy alloc strategy */ 

/* set this to >" half n_ttyLines/fnp for safety */ 



/* histogram of run depths */ 

if* histogram of tiroes run per depth */ 

/* histogram of page faults per depth */ 

I* times ptljwait noticed ptl was unlocked */ 
/* times window noticed */ 
/* o-locked, else unlocked */ 

num calls to ptljwait */ 
/* to detect gw_gp window lossage 

(* next time at which nto code will be called */ 
I* microsec between nto checks */ 
/* number of times nto detected */ 

/* obsolete */ 
/* last event which NIO'd */ 



/* used to be tcm. inter */ 

/* num apte's in each state */ 



/* histogram of page fault waiting times versus did */ 



/* histogram of times in ready queue */ 



/* total time spent from start to end of 

all page faults */ 
/* total number of page faults metered *t 
I* 0'"> dont, atherwise compensate for quantum len */ 
/* number of pages reserved for int users */ 
/* total of eligible' s ws_sizes */ 
/* count of eligibilities forced */ 
/* Lock on ITT free list */ 

/* total cpu time spent handling page faults */ 
/* total count of cpu time meterings */ 
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3 «pt_offset bit (18), 

3 j>ad~blt (18). 
Z getwork_tlrae fixed bin (71), 
2 getwork_count fixed bin (18), 
2 ahoct_pf_count fixed bin (18), 
2 lnterrupt_tlme fixed bin (71), 
2 lnterrupt_count fixed bin (71), 
2 ocoxe fixed bin (35, 18), 
2 px«_eiiipt_flag bit (36) aligned, 
2 eumulatlvejn>emoxy_usage fixed binary (71), 
2 proce5aor_tline_at_def Inejvo fixed bin (71), 
2 boost_prlorlty fixed bin, 
2 Lo;st_prlorlt7 fixed bin, 
2 total_clock_lag fixed bin (71), 
2 clock_sliDulatlona fixed bin, 
2 inax_clock_lag fixed bin, 

/* 300 octal */ 

2 pdseopyl fixed bin (18), 

2 inax_hproo_segno fixed bin, 

2 pxds_Iength fixed bin (18), 

2 pdii_length fixed bin (18), 

2 Lock fixed bin (18), 

2 id bit (36) aligned, 

2 By3teiii_ahutdown fixed bin (18), 

2 woxklng_9et_f actor fixed bin (33, 18), 

2 ncpu fixed bin (18), 

2 Ia.it_ellglble bit (18), 

2 apt_lock fixed bin (35), 

2 apt.sise fixed bin (18), 

2 realtime_q aligned like baaed_sentinel, 

2 aht_size fixed bin (18), 

2 itt_size fixed bin (18), 

2 dse_siza fixed bin (18), 

2 lttt~free_list bit (18), 

2 used_itt fixed bin (18), 

Z initializer_id bit (36) aligned, 

2 n_»ligible fixed bin (18), 

2 !na»_eligible fixed bin (30), 

2 walt_enable fixed bin (18), 

2 apt_entry_slse fixed bin (18), 

2 inii:eractive_q aligned like based_8entlnel, 

2 dstjptr ptr, 
2 old_user ptr, 

2 initial ize_tiine fixed bin (71), 

2 in:Lt_event fixed bin (18), 

2 oldt fixed bin (18), 

2 newt fixed bin (18), 

2 tefirst fixed bin (30), 

2 telaat fixed bin (30), 

2 timax fixed bin (35), 



*.* 



torn. 



total time spent in getwork */ 
'* toial times through getwork */ 
'* number of short page faults */ 
'* total time spent in Interrupt */ 
'* total number of metered Interrupts */ 
'* fraction of core for Int've users */ 
'* controls whether preempting at done time */ 
'* total number of coemory usage units */ 
'* value of processor_tlme when UC's last defined */ 
'* nuniber of times priority process given high priority 
'* number of times priority process lost eligibility *l 
'* sum of all simulated dock delays */ 
'* number of times alarm clock interrupt was simulated */ 
'* largest simulated alarm clock delay */ 



f* amount of pds to copy for new process */ 

f* largest allowed liardeore segment number */ 

f* length of PROS */ 

r* length of PDS */ 

r* process Id generator lock */ 

next uld to be added to uld_array */ 

working set factor */ 

number of procesiiors currently being used */ 

last process to gain eligibility */ 
'* + write i 0 hiddent -1 unlocked t -(N+1) Nreaders */ 
'* number of APT entries */ 
r* processes with realtime deadlines */ 
'* APT hash table size */ 
'* number of ITT ent:ries */ 

number of allowed DST entries */ 
'* pointer to ITT free list */ 

nimber of used ITT entries */ 
'* process id of initializer */ 
'* number of processies eligible */ 
'* maximum allowed number of eligible processes */ 
'* turned on when waiting mechanism works */ 
'* size of an APT entry */ 

'* head of interactive queue *l 
'* pointer to devicci signal table */ 
'* last process to iMa (apt ptr ) */ 
'* time of initialisiation 

'* wait event during; initialization */ 

* timer reading frcm previous process */ 

* timer setting foi' new process */ 

* first eligible tline */ 

* last eligible time */ 

* time in queue for lowest level */ 
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2 orapty_q bit (18), 
2 worfclng_sat_addend fixed bin (18), 
2 xead7_q_h«ad bit (0) aligned, 
2 cLigible_,q_head aligned like based_8entinel, 
2 raady_<i_tail bit (0) aligned, 
2 eligible_q|_tail aligned like baaed.aentinel, 
2 idle_tail aligned like based_8entinal, 
2 min.eligible fixed bin (30), ~ 
2 alarm_timer_list bit (18) aligned, 
2 guaranteed_elig_ine fixed bin (35), 
2 prior ity_8ohed_ino fixed bin (35), 
2 next_alaxm_tiine fixed bin (71), 
2 priority_ached_time fixed bin (71), 
2 opc_polling_tiine fixed bin (71), 
2 disk_polling_tiine fixed bin (71), 
2 t«pe_polling_time fixed bin (71), 
2 lmp_polling_tiine fixed bin (71), 
2 imp_polling^lock fixed bin (18), 
2 inax_ohannel8 fixed bin (18), 

/* 400 octal */ 

2 system_virtual_tiine fixed bin (71), 
2 credit'bank fixed bin (71), 
2 min_vct_index bit (18) aligned, 
2 inax_wct_index bit (18) aligned, 
2 delta_vt fixed bin (71), 
2 gross_idle_tiroe fixed bin (71), 
2 credita_per_scatter fixed bin (35), 
2 best_credit~value fixed bin (18), 
2 def ine_wc_tlme fixed bin (71), 
2 max_batch_elig fixed bin (35), 
2 nuin_batch_elig fixed bin (35), 
2 deadline_inode fixed bin (35), 
2 credits_3cattered fixed bin (35), 
2 max_max_eligible fixed bin (30), 
2 max_stopped_stack_0 fixed bin (35), 
2 stopped_stack_0 fixed bin (35), 
2 mos_polling_interval fixed bin (35), 
2 moajpolllng_tline fixed bin (71), 
2 vcpu_reaponae_bounda (VCPU_RESPONSE_BOUNDS) fixed bin 
2 vopu_respon9e_1bounds_slze fixed bin (35), 
2 meter_re8ponse,_time_calla fixed bin (35), 
2 ffleter_reapon«e,_time_invalid fixed bin (35), 
2 meter_re8pon8e_time_overhead fixed bin (71), 
2 init_wait_tinie fixed bin (71), 
2 init_wait_tiroeout fixed bin (71), 
2 init_timeout_s«verity fixed bin, 
2 init_timeout_recurse fixed bin, 
2 max__timer_regiater fixed bin (71), 
2 pre_einpt_8ainpla_tiiM fixed bin (35), 
2 goveming_credit_bank fixed bin (35), 
2 process_initiaL_quantum fixed bin (35), 
2 default_j>roc8_required bit (8) aligned, 
2 work_cla88_idr« fixed bin (71), 



I* thread of empty AFT entries */ 
/* additive working set parameter */ 
/* for added aegdef */ 
if* head of eligible queue */ 
/* for added aegdef */ 
/* tail of eligible queue */ 
/* tail of idle list */ 

if* rel pointer to apt entry for next alarm timer */ 

I* amount of guaranteed eligibility time in microseca. */ 

/* amount of block time before process ia given priority */ 

/* clock time for next alarm timer */ 

/* tinia for priority prooesa to be given priority */ 

I* time to poll console DIM */ 

{* time to poll disk DIM */ 

/* time to poll tape DIM */ 

/'* time to poll imp */ 

/* do not poll if look set */ 

/* num special channels per process */ 



/* non-idle virtual time */ 

f* oredita not yet passed out */ 

/* offset of initialiser work class table entry */ 
/* offset of highest vote currently defined */ 
/* temp used by pxss .compute_virtual_clocka */ 
/* idle time_uaed_clock */ 

/* total number of credits awarded at once */ 

/* ten^ for pxss.f ind_next_eligible */ 

/* clock time when workelas ses last degined */ 



/* o>> ti sorts, else deadline sorts */ 
/* Maximum of maxe */ 

/* Maxioium stack_0's suspended by stopped procs */ 
/* Number stack_0's suspended by stopped procs */ 
/* for heals */ 
/* for heals */ 
(35), 



'* used by wait/notify during initialisation */ 

* notify-timeout interval during Initialisation */ 
'* notify-timeout severity during initialization */ 
'* count of NTO recursion during initialization */ 
'* max cpu burst " # cpus x pre_einpt_sample_time */ 

* timing parameter - max time between samples */ 

* used for limiting eligibility on governed work classes*/ 

* eligibility quantum first eligibility */ 

* default mask of CPUs required */ 

* idle time due to work class restrictions */ 
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/* Tuning Parwa«t«rs for St;ack Trtmcation */ 

2 3tk_truncate bit (1) aligned, 
2 9tk_truncate_always bit (1) aligned, 
2 3tk_trunc_avg_fl fixed bin (35, 18), 
2 3tk_trunc_avg_f2 fixed bin (35, 18), 
2 lock_error_s«verlt3r fixed bin, 

2 gv^lntegratlon fixed bin (35), 

2 gv_,lntegratlon_set bit (1) aligned, 

2 pauses fixed bin (35), 

2 voIinap_polllng_tinie fixed bin (71), 

2 ne»t_ringO_timer fixed bin (71), 

2 xealtlroe_lo_priority_awitch fixed bin, 

2 realtline_lo_deadIine fixed bin (35), 

2 realtlme_lo_quantuin fixed bin (35), 

2 xealtlmejprioxitiea fixed bin (35), 

2 relinquishes fixed bin (35), 

2 abort_ips_mask bit (36) aligned, 

/* 500 ocstal */ 

2 uid_array (0:15) bit (36) aligned, 
2 pads (176) fixed bin (35), 

/* 1000 octal */ 

2 pad7 (64) fixed bin (35), 

/* 1100 octal */ 

2 pad6 (8) fixed bin (35), 
2 work_claas_table aligned, 

3 wcte (0il6) aligned like wct_entry, 

/* 3000 octal */ 

2 apt fixed blni 

del wctep ptrt 

del 1 wct_entry aligned based (wctep), 
2 thread unaligned, 

3 fp bit (18), 

3 bp bit (18), 
21 flags unaligned, 

3 itmbz bit (1), 

3 defined bit (1), 

3 Lo_prlorlty bit (1), 

3 governed bit (1), 

3 Lnter8Ctlve_q bit (1), 

3 pad bit (31), 
2. credits fixed bin (35), 
2! Biinf fixed bin (35), 
2 pln_welght fixed bin (35), 
2 eligibilities fixed bin (35), 



/* syserr severity */ 



/* Integration interval for governing *l 
I* ON "> 8v_integration set by ctp */ 
/* Calls to pause (reschedule) */ 

/* next time that ring 0 timer goes off */ 

/* 0 ■> give I/O interrupt vakeupa realtime priotiry 

/* Delta to clock for I/O realtime deadline */ 

/* Quantum for I/O realtime burst */ 

/* Count for metering */ 

/* Calls to rellnqulsh_prlority */ 

/* IPS mask for te_utll$cheek_abort */ 



/* array from which a uid is chosen (randomly) */ 
/* room for expansion compatibly */ 



/* array of per workclass information */ 



/* Work class entry */ 
/* Ready list */ 
/* Head of ready Hat */ 
/* Tail of ready list */ 

/* Sentinel bit must not be zero. */ 



/* (hirrent worthiness of group *l 
I* min fraction of cpu */ 
/* number of cycles to pin pages */ 
/* Count of eligibilities awarded */ 



2 cpu_sum fixed bin (71), /* CPU used by membeir* */ 

2 reapl fixed bin (71), 

2 re8p2 fixed bin (71), 

2 quanturol fixed bin (35), 

2 qu8ntuiii2 fixed bin (35), 

2 rmeterl fixed bin (71), 

2 rmeter2 fixed bin (71), 

2 roountl fixed bin (35), 

2 roount2 fixed bin (35), 

2 realtinw fixed bin <35), 

2 purging fixed bin (35), 

2 owxeL fixed bin (35), 

2 neL fixed bin (35), 

2 number_thinks fixed bin (35), /* nuntber time* process entered "think" state */ 

2 number_queues fixed bin (35), /* number tllmes process entered "<iueued" state */ 

2 total_thlnk_tiine fixed bin (71), 
2 totaL_queue_tlxne fixed bin (71), 

/* The next three arrays correspond to the array vcpu_re«p0nse_bounds */ 

2 nuiiiber_proces fling (VCPUJRESPONSE_BOiniDS-«-l) fixed bin (.^(5), /* number times entered "processing" state */ 

2 totaI_proceaalng_tlma (VCPUJtESPONSE_BOUNOS+l) fixed b];.n (71), 
2 total_vcpu_tln)« 7vCPU_RESP0NSE_B0UNDi+l) fixed bin (71), 

2 maxf fixed bin (35), f* maximum fraction of cpu time */ 

2 govemlng_credlts fixed bin (35), {* for limiting cpu resources */ 

2 padl (4) fixed bin (35) t 



del 1 based_sentinel aligned based, /* format of pxss-style sentinel */ 

2 fp bit (18) unal, 
2 bp bit (18) unal, 
2 sentinel bit (36) alignedt 

del VCPU_R£SPONSE_BOUNDS fixed bin Inlt (3) Int static options (constant) i 

/* END INCLUDE FILE tcm.incl.pll */ 



tcm.lncl.pll 



Page 81 



vol_inap . :lncl . pLl 



segment in: 
entry modified: 



>Ldd> include 
06/21/83 1914.2 



contents modified: 04/29/76 1050.5 



/* BEGIN INCLUDE FILE ... vol_iluq>.inbl'.pll */ 

del vo]l_mapp ptri 

del 1 vol_ffiap based (voljnapp) aligned/^'- 

2 n_ffec fixed bin(17); 

2 ba.ie_add fixed* bind?) , 

2 n_£ree_rec f ixed' blntl^) , e - ^ 

2 bit map_n words' fike«t'bin(17},>^''~ 

2 pad~(607 bitO*)-, ' ' ' ' 

2 bit_map (3*1024 - W) bit(36) V'**- 



/* number of records represented in the map */ 

/* record number for first bit in bit map */ 

/* number of free records */ 

/* number of words of the bit map */ 

/* pad to 64 words */ 

/* bit map - the entire vol map occupies 3 records 



*/ 



/* END INCLUDE ... vormap */ 



*.* 
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vtoc_bu£f er . inci .pll. 



segment ins >ldd>include contents modifledi 11/23/82 0933.9 

entry modified: 06/21/85 1917.2 



/* START OFs vtoc_buffer.lncl.pll November 1982 *****************/ 



del vtoo_buffer_aeg$ extt 

del vtoe_buffer_^segp ptrt 

dol vtoo_bu£_descp ptri 

del vtoo_bui£p ptri 

del vtoc_buf_d«se_arrayp ptrt 

del vtoc_buf_arrayp ptrt 

del vtoo_bu£_n_buffera fixed bint 

dol vtoo bu£_n_bucket* fixed bint 



dol 1 vtoo_buffcr aligned based (vtoo_bu£f«r_segp) , 



2 


lock. 








/* 


Global look for VTOC buffers */ 




3 process id 


bit (36) aligned. 


/* 


Owner '''/ 




3 wait_event 


bit (36) aligned. 


/* 


For lock */ 




3 notify_aw 


bit (1) aligned, 


/* 


OH notify on unlock * / 


2 


n_buf8 


fixed 


bin 




1* 


Number of full VTOCE buffers */ 


2 


n_hash_buckets 


fixed 


bin, 




/* 


Number of hash table buckets */ 


2 


hashjnaak 


bit (36) aligned. 


/* 


Mask for hash algorithm */ 


2 


abs_addr 


fixed bin 


(24), 


/* 


Absolute address of vtoc_buffer_seg */ 


2 


wait event constant fixed bin (36) una 


unal. 


/* Constant to add to part index to form wait event */ 


2 


buf_deso_offset 


bit (18), 




/* 


Offset of buf_deso */ 


2 


buf_off8et 


bit (18), 




1* 


Offset of buf"*/ 


2 


hash_table_offset 


bit (18), 




1* 


Offset of hash_table */ 


2 


search_index 


fixed 


bin, 




1* 


Roving pointer for buffer selection */ 


2 


unsafejpvtx 


fixed 


bin, 




/* 


PVTE index with update in progress */ 


2 


scavenger_£reejp_elock 














fixed 


bin 


(35), 


/* 


Pseudo-Clock for soavenger-free-other-alloeate race */ 


2 


meters; 














3 call_get 


fixed 


bin 


(35), 


/* 


Calls to get_vtoce */ 




3'calljpiit 


fixed 


bin 


(35), 


/* 


Calls to put_vtoce */ 




'3 cill_alloc 


fixed 


bin 


<35), 


/* 


Calls to alloc_and_put_vtooe */ 




3 caLl_££ise ?' ' ■ 


fixed 


bin 


(35), 


1* 


Calls to free_vtooe */ 




3 odtVjMtiit 


fixed 


bin 


(35), 


/* 


Calls to await_vtoce */ 




'3'''s'teps ■ ' 


fixed 


bin 


(35), 


1* 


Steps through buffer allocation */ 




'3 ''skip_o's 


fixed 


bin 


(35), 


/* 


Skipped because out-of-soinrice */ 




3 skip_hot 


fixed 


bin 


(35), 


I* 


Skipped because buffer hot */ 




3 sk£p_wait 


ffxed 


bin 


(35), 


1* 


Skipped because notify^sw set */ 




3 disk_reads 


fixed 


bin 


(35), 


1* 


Number of same */ 




3 dlsk^writes 


fixed 


bin 


(35), 


1* 


Number of same */ 




3 gat_bu£fer_calls 


fixed 


bin 


(35), 


/* 


Number of calls to GET_BUFFER */ 




3 g(St_buffer_hit» 


fixed 


bin 


(35). 


1* 


Number times VTOCE in buffer */ 




3 wait_calls 


fixed 


bin 


(35), 


1* 


Number of calls to WAIT */ 




3 wait OS 


fixed 


bin 


(35), 


1* 


Number of times had to wait */ 




3 scavenger_£ree_checks 
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v«tK«d bin <3»), 
3 spa.v«n8«r_,fr«e_loss«s 

flMd W«i (35), 

3 pad (15) 



2 hash tabic 



>* IliWbar -o^ tlinas had l«» cftiaok p»i^ 
/* Numbar of times iraea Lost betwaen «cay«ti$«£ f and othar «ilooata */ 



fiJt^d bin (35), 

(vtoc_buf_n_buckats rafar (vtoo_bu££ar.n_ha»h_buekats)) bit (18) allgnad, 



2 buf_daso 
2 buff ar 



(vtoe_buf_n_buffars rafar (vtoo_buffar.n_bu£s)) alLgnad Ilka vtoo_bufjlase, 

-ill-.' vr-v- - i 

(vtoe_bufjn_buff an rifar (vtoe_buffar.n_bui:s)) alLgnad Lika iTteea^buffari 



del 



1 vtoo_b\if_dasc_array (vtoe_buffar.n_bufs) alLgnad based (vtoc_bu£jdasc_arrayp) LLka vtoo_bufjdasei 



dol 



del 
doL 



1 vtoc_bu£_daso 
2 pvtK 
2 vtocx 
2 partsjusad 
2 err 

2 notLfy^aw 
2 wrLta_,aw 
2 OS 
2 Loq 
2 used 
2 pad 

2 wait_Lndex 
2 ht_thread 

2 bu£ rel 



aligned based (vtoo_buf_ 

fixed bin (17) unalT 

fLxed bLn (17) unaL, 

bit (3) unal, 

bLt (1) waL, 

bit (1) unal, 

bit (1) unml, 

bit (1) unal, 

bit (1) unal, 

bit (1) unaL, 

bit (9) unal, 

fixed bin (17) unaL, 

bit (18) unal, 

bit (18) vmali 



dascp) , 

'/* PVTE index */ 

/* VTOCE Index */ 

/* Kask of parts used or os */ 

/* ON -> I/O error cm buffer */ 

/* ON notify requied on I/O eoiq>LetLon */ 

/* ON -> write I/O */ 

/* ON -> I/O In progress */ 

/* ON -> I/O has beon requested */ 

/* ON -> this descriptor is in use */ 

/* Buffer index for forming wait event */ 
/* Offset of next entry in hash table */ 
/* Offset of buffer in segment *l 



1 vtoce_bu££er_array (vtoc_bu£fer.n_bu£s) aligned based (vtoe_bui:_arrayp) like vtooe^bufferi 



1 vtoce_buf£er 
2 parts 
3 words 



aligned based (vtoo_bufp), 

(3) aligned, 

(64) bit (36) alLgnad I 



del N_PARTS_PER_VTOCE 

del VTOCE_PART_ilZE 

del VTOCE~BUFFER_SIZE 

dol N_VTOCE_PER_RECORD 

del M SECTOR P^ VTOCE 



fixed bin int static options (constant) Inil: (3)i 

fixed bin int static options (constant) init (64) i 

fixed bin int static options (constant) inin (3 * 64) i 

fixed bin int static options (constant) Lnit (5)i 

fixed bin int static options (constant) LnLt (3)i 



/* END OFs 



vtoc_buf far . incl .pll 



*/ 
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vtQO_h«ad«r. Inol .pll. 



■•Snwnt int >Ld<l>lnolwl« contents modlfladi OS/23/77 0919.3 

entry tootllfied: 06/21/85 1914.2 



/* BEGIN IHCLUDE FILE ... vtoo_h«ad«r.inoL.pLl */ 
del vtooJh«ad«rp ptri 

del 1 vtoo_h«ad«r hmamd (vtoe_head«txp) aligned , 

2 varalon fixed bin (17), 

2 n_vtoee fixed bin (17), 

2 vtQa_laat_reono fixed bin (17), 

2 n_free_vtooe fixed bin (17), 

2 flr»t_frec_ytoox fixed bin (17), 

2 pad (3) bit (36), 

2 diii|pr_bltjiiap (204S - 8) bit (36) i 

/* END INCLUDE ... vtoo_header */ 



/* version number. The current version number Is 1. * */ 
/* number of vtoe entries */ 

/* record number of the last record of the vtoo */ 

/* number of free vtoe entries */ 

jf* Index of the first vtooe In the free List */ 

/* space for dnpr bit map */ 



;vtoi^« , :L«utt .pit 



••SUMmt ' ini >£t3^jUioLud« 

•ntrjr 'modified I 06/21/83 1917.9 



eontsnts modiflsdt ia/Q4/93 11Q3.1 



/* BGOIM IlKlLi^E fII3 .••vtoo«.lncL.pIl ... Uat modified September 1982 */ 

/*;^Teii4»t»te f«>i; • VTOC miry. Length ■« 192 words. <3 * 64). */ 
/* HQTEt vtpojiiwn:^ilsil«are pitd field* before writing e'vtoce. */ 

del vtociep ptr t 

doL 1 vtoee bMed (vtoeep) . aligned , 



(2 paid;_free_vtoee_eh«ln bit (36), 
2 Ml« bit v(36). 

2 nsi bit (9), 

1 e«l :blt;(9), 

2 recQsde bit (9), 

2 pid2 bit (9), 

2 dtvi bit (36), 

2 dtni bit (36), 

2 nqsw bit (1), 

2 df^iiduoua bit (1), 

2 nid bit (1), 

2 diiKp bit (1), 

2 gtpd bit (1), 

2 perjpirocess bit (1), 

2 daniaged bit (1), 

2 fm^damaged bit (1) , 

2 fin;..ehec1c«Mm_valid bit (1), 

2 itynchronii^dd bit (1), 

2 pa43 bit m. 

2 dirsw bit (1), 

2 maiiter dir bit. (1), 

2 pa«l4 bit (16)) phaUgned, 

2 fm„cheeksum bit (36) aligned, 

(2 qiiota (Oil) fixed bin (18) unalgned, 

2 used (Oil) fixed bin (18) unsigned, 

2 received (Oil) fixed bin (18) unsigned, 

2 trp tO^l)^ fixed bin (71), 

2 tri^time (Oil). bit. (36) , 



/* Used to be pointer to next free VTOCB */ 

/* segment's uid - sero If vtoce Is tiemm *ti 

■ ■ ' 'ip 

(* oiaxlmum segment length In 1024 woutt unlt'# */ ' 

current segment length - in 1024 word unlt4|, 
/* number of records used by the'.'seg In second storafe Iff 

■ m , , 

/* date and time segment was last used */ 

/* date and time segment was last modified *l 

I* no quota switch - no checking for pages of this seg */ 

/* true if hc_adw */ " . 

/* no incremental dusip switch */ 

/* Dont null' Mere pages */ 

/.* Global transparent paging device *l 

/* Per process segment (deleted every bobtload)^: */ 

/* tiil$ if contents damaged */ 

/* -fHUE if f ilestap checksum bad *( 

I* TRUE If the ehecksvim has beeii csonputed */ 

/* TRUB If this Is a data management synchronised segmeht *./ 

/* directory switch */ 

f* ntaster dlreptoxy - a root for the logical volume' */ 
/• not used */ 

/* cnwckstim of iised portion tit file map */ 

/* seo ftorage quota - (0) for non ilir pages */ 

/* seo storage used - (0) for non dlr pages 

I* total amount of storage this dir has received */ 

/* tlote record product - (0) for non dlr pages */ 

f* time tlme_reeordjproduot was tast calculated */ 
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